list Subcommand Overview - Oracle® Server CLI Tools for Oracle Solaris 11.3 User's Guide

Language:

`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. This target was introduced in Oracle Solaris 11.3 SRU 18.
`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.

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.
`–y`	`--yes`	Bypass any 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*