list Subcommand Overview

The list subcommand does the following:

Displays the version of firmware for all components
Tells you whether the target device can be updated with the XML metadata file
Saves the configuration information to a specified XML file

This information can be used to check the state of a device before executing a firmware update and can be used to verify that a firmware update has been successful. The device naming convention used for target devices is shared with other Oracle Hardware Management CLI Tools.

The format for using the list subcommand is:

fwupdate list target options

The supported targets for the list subcommand are listed in the following table.

Target	Description
`all`	All supported component types, such as disks, expanders, controllers, bridge devices, and system firmware (including Oracle ILOM) that can be updated using an XML metadata file included with a firmware package.
`disk`	Supported hard disk drives and solid state disk drives.
`expander`	Supported SAS expanders.
`controller`	Supported controllers, such as storage and networking. Note: Controllers that are not updatable by `fwupdate` will not be listed.
`bridge`	Supported embedded SAS-to-SATA bridge devices (used on some older systems).
`sp_bios`	System firmware on x86 or SPARC, including BIOS/OBP and Oracle ILOM. Note: This target has been deprecated and is replaced by the `sysfw` target.
`sp-bios-backup-firmware`	Update the Oracle ILOM backup image and perform pre-update tasks as the first step to a BIOS/ILOM firmware update on an x86 system. The second step, loading the backup image and resetting the system to use the new firmware, is done from Oracle ILOM and can be delayed until a convenient time. This option was introduced in Oracle Hardware Management Pack 2.4.5.
`sysfw`	System firmware on x86 or SPARC, including BIOS/OBP and Oracle ILOM.
`sysfw-backup-firmware`	Update the Oracle ILOM backup image and perform pre-update tasks as the first step to a sysfw/ILOM firmware update on a SPARC system. The second step, loading the backup image and resetting the system to use the new firmware, is done from Oracle ILOM and can be delayed until a convenient time. This option was introduced in Oracle Hardware Management Pack 2.4.5.
`fallback_boot`	For SPARC systems with an SP that contains an updatable fallback boot image. This target was introduced in Oracle Hardware Management Pack 2.4.
`supported-targets`	List supported `fwupdate` component types that can be automatically updated using an XML metadata file. The firmware for these components can be updated individually or all at the same time using an XML metadata file included with a firmware package.
`supported-images`	List supported `fwupdate` component image types that can be manually updated. The firmware images of these components are individually updated by applying a firmware package image file.
`error-codes`	List all of the `fwupdate` return codes.

The list options are listed in the following table. When executing this command over a remote network connection, see fwupdate and Service Processor Access.

Short Option	Long Option	Description
`-n`	`--device_name`	Allows a mandatory parameter to designate a single device to list. The `--device_name` option is the common-mapped device name. For more information, see CLI Tools Device-Naming Convention.
`-v`	`--verbose`	Displays detailed information about each component listed. Verbose is off by default.
`-x`	`--xml=filename.xml`	Uses the provided XML metadata file to determine which components are supported. Note: When the `-x` option is used to specify a metadata file, the devices discovered might change because the "software_type" specified in the metadata file may limit which devices are discovered. This might cause the device ID to change when specifying a metadata file with `-x` option.
`-Q`	`--quick`	Optimizes access to include only the targeted devices during device discovery when using the `-x` option to specify a firmware metadata file. This can reduce the time it takes to execute the command. This option was introduced in Oracle Hardware Management Pack 2.4.9.0.
`-o`	`--output_xml=filename.xml`	Prints the configuration information in XML format to the given file. Note: This output option is not supported when using the list subcommand with the supported-targets, supported-images and error-codes targets. If you need to save information listed for these targets, you can redirect the standard display output to a file.
`-y`	`--yes`	Bypass user confirmation prompt when overwriting an existing output file of the same name.

The following information is displayed with the fwupdate list all command. Items marked with an asterisk (*) are displayed in verbose listing.

SP (SPARC) or SP + BIOS (x86)
- ID
- Product Name
- ILOM Version
- BIOS/OBP Version
- Fallback Boot Version (SPARC systems that support it)
- XML Support
Controllers
- ID
- Type
- Manufacturer
- Mode
- Product Name
- Firmware (F/W) Version
- BIOS version
- EFI Version
- FCODE Version
- Package Version
- NVDATA Version
- XML Support
- NODE ID*
- Part Number*
- PCI Address*
- PCI Vendor ID*
- WWN*
Disk
- ID
- Manufacturer
- Model
- Chassis
- Slot
- Type
- Media
- Size
- Firmware (FW) Version
- XML Support
- NODE ID*
- WWN*
Expander
- ID
- Chassis
- Slot
- Manufacturer
- Model
- Expander Name
- Firmware (F/W) Version
- XML Support
- NODE ID*
- Product Revision*
- WWN*
Bridge
- ID
- Chassis
- Slot
- Manufacturer
- Model
- Firmware (F/W) Version
- Att FW Version
- XML Support
- NODE ID*
- WWN*

Parent topic: Listing Component Firmware Information