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.
sysfw	System firmware on x86 or SPARC, including BIOS/OBP and Oracle ILOM.
fallback_boot	For SPARC systems with an SP that contains an updatable fallback boot image.
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.
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.
-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*