Exit Print View

CLI Tools User's Guide for SPARC Servers

Get PDF Book Print View

Document Information


About This Documentation (PDF and HTML)

We Welcome Your Comments

Change History

Installing fwupdate CLI Tool

How to Install fwupdate

fwupdate Tool Command Syntax and Conventions

CLI Tools Command Syntax

CLI Tools Device-Naming Convention

Using the fwupdateTool

fwupdate Command-Line Interface

list Subcommand

reset Subcommand

update Subcommand

Device-Naming Convention

Execution Summary

Error Codes

Common Error Codes

fwupdate Error Codes

fwupdate Command-Line Interface

Command-line mode is designed to update a single component with a user-specified firmware file.

The following restrictions apply when using the fwupdate command:

Note - For Solaris, after hot-plugging any device, run the devfsadm -C command to reenumerate all of the system device nodes before running the fwupdate command.

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

Note - Default (noarg) behavior of the tool lists the help options. Incomplete command-line arguments result in an error, and context-sensitive help is displayed.

The following table shows the options that apply to all CLI tools commands including fwupdate.

Short Option
Long Option
Displays help information.
Displays the tool version.
Suppresses informational message output and returns only error codes.

The tool uses the following syntax:

fwupdate subcommand device_type option

where subcommand is one of the options shown in the following table.

Listing mode displays system data and helps select components for upgrade.
Update mode allows updating a single component based on command-line directives.
Reset mode allows resetting of individual components.

The preceding subcommands have the options shown in the following table.

The help option provides context sensitive help for that subcommand. After every command or subcommand, can you type --? or --help to discover the additional available subcommands or options.
The quiet option outputs the mode with no prompting or stdout reporting. All output goes to a log file.
The version option prints version information of the tool.

See also: