list Subcommand Overview - Oracle® Server CLI Tools 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.
`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 for SPARC and is replaced by the `sysfw` target.
`sysfw`	System firmware on SPARC, including OBP and Oracle ILOM.
`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.

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.

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
- 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*