fwupdate Command Syntax

The fwupdate command uses the following syntax:

fwupdate subcommand target options

If you use the --help or --version options, the fwupdate command does not require subcommands; otherwise a subcommand is mandatory.

When a command fails, it returns one of the failure codes listed in fwupdate Error Codes.

fwupdate supports the subcommands listed in the following table.

Subcommand	Description
`list`	Provides firmware information about a device or a file. For targets and options specific to the `list` subcommand, see Listing Component Firmware Information.
`update`	Updates the firmware of one or more system components based on command-line directives. Devices can be updated automatically using metadata information contained in an XML file included with the device patch (recommended), or updated manually using a firmware image file. For targets and options specific to the `update` subcommand, see Updating Component Firmware.
`reset`	Resets the specified device if the device supports a reset. Perform a reset on a device after a firmware update (if required). In some cases where the metadata used in an automatic mode firmware update does not automatically reset a device that requires one, this subcommand can be used. For targets and options specific to the `reset` subcommand, see Reset a Device After a Firmware Update.

The following table lists general options available for fwupdate. Options specific to each subcommand are described in the section that describes using the subcommand.

Short Option	Long Option	Description
`-?`, `-h`	`--help`	Displays help information.
`-H`	`--remote-hostname=sp_ip`	The host name, Common Name, or IP address of the remote service processor as specified by sp_ip. This option must be used in combination with the -U option. Note: When accessing an SP over a remote Ethernet network connection, client-side SSL certificate validation is performed by default. For proper validation, you must use the Common Name stored in the client-side SSL certificate and the DNS server for the SP remote host name (e.g. `-H ORACLESP-1000NML000`). Otherwise, you will receive a "hostname validation failed" error.
`-U`	`--remote-username=username`	The user name with root access used to log in to the remote service processor as specified by username. This option must be used in combination with the `-H` option.
`-V`	`--version`	Displays the tool version.
`-q`	`--quiet`	Uses silent, non-interactive mode. Suppresses user prompts and informational message output and only returns error codes during the update. Useful for scripting. Note: When using the quiet option, if the --no-cert-check option is not used and the certificate validation fails the utility will return an error.
`-t`	`--intfname=interface`	Specifies the IPMI interface to use. No auto-detect is attempted. Supported interfaces that are compiled in are visible in the usage help output (socket interfaces in case `-H` option is used). See the `-T` description for more information. This option was introduced in Oracle Solaris 11.4 SRU 57.
`-T`	`--remote-intfname-fallback=interface`	Selects the least secured IPMI socket interface to use if more secure interfaces are not supported. The tool attempts the most secure interface first (orcltls). If the BMC does not support the interface, then attempt the next most secured socket interface until the specified interface. Supported socket interfaces that are compiled in are visible in the usage help output in the appropriate order. If lanplus or lan is specified, certificate checking is disabled when attempting the orcltls interface. Note: If the `-T` or `-t` option is not specified, then no auto-detect is enabled and only the orcltls interface is attempted including certificate checking. This option was introduced in Oracle Solaris 11.4 SRU 57.
`-y`	`--yes`	Bypass user confirmation prompt when overwriting an existing output file of the same name.
n/a	`--cert-dir=pathname`	Location of trusted certificates as specified by pathname. Use this option if your client-side SSL certificate is in a different directory than the expected default system certificate directory.
n/a	`--no-cert-check`	Do not perform SSL certificate checking.

Parent topic: fwupdate Command Overview