fwupgrade(8)fwupgrade(8)NAMEfwupgrade - Updates the system firmware from a loadable firmware image
(*.exe or *.sys)
SYNOPSIS
/sbin/fwupgrade [-a] [-e] [-ignore] [-q] [-r] [-s] [-v] [-t
CD-ROM_path] [-i path]
/sbin/fwupgrade [-v] -f firmware_filename
OPTIONS
Forces a firmware update without comparing the current firmware with
the source firmware. Specifies the name of the network interface (for
example, ee0) to be used to perform a network firmware upgrade. This
option is only used when you use a firmware image on a remote system to
perform the upgrade. The -n option must be used with this option.
Updates only if the current firmware is not equivalent to the source
firmware. Specifies the path of the (*.exe or *.sys) firmware image.
This is only used when you use a firmware image that is not on the dis‐
tribution CD-ROM. For example, an image obtained from a web site down‐
load. You must ensure that the firmware image is the correct one for
the target system, and verify that the image has the necessary support.
This is indicated by bit1 and bit2 in the Flags column of the
smmtable.txt file. Specifies the mount point of the target disk during
an installation. This switch is to be used exclusively by the Tru64
UNIX install program. This switch suppresses error messages that are
displayed if no firmware files are found on the distribution media, and
causes the fwupgrade program to exit successfully. Specifies the name
of the network bootable firmware image (*.exe or *.sys with no path
specified). This is only used when you use a remotely located firmware
image instead of the distribution CD-ROM. You must manually ensure
that the firmware image is valid for the target system and verify that
the image has the necessary support. This is indicated by bit1 and bit2
in the Flags column of the smmtable.txt file. This flag must be used
in conjunction with the -doption Does not upgrade the firmware, but
displays information about the success of the desired operation. This
enables you to to query fwupgrade to verify planned actions, such as
ensuring whether the firmware really needs to be upgraded, or finding
out if the target system supports a soft-reset. Resets the machine by
software and reboots after the upgrade. The utility will exit with an
error status if the system hardware does not support this feature.
Sets silent mode, in which the firmware is upgraded without prompting
you. If there is an error, the program also exits silently without
prompting you. When this switch is used, you are not prompted for con‐
firmation for the upgrade to proceed. Specifies the path of the
mounted Firmware CD. If the -s option is not specified, you will be
prompted to enter this path. Sets verbose mode, in which additional
information is displayed.
DESCRIPTION
The fwupgrade command provides a means of updating the system firmware
when a (*.exe or *.sys) loadable firmware update image is available. A
firmware upgrade will shut down the system and require a full hardware
reset. If the source firmware image does not support the loadable
firmware update functionality, fwupgrade will exit with error status.
The system must provide a SAVE_ENV callback that complies with the
Alpha SRM.
In order to perform a network firmware update, the -n and -d options
must both be used. The network protocol console environment variable
corresponding to the intended network device must be set to BOOTP. For
example, if the eia0 network adaptor is used, eia0_protocols must be
set to BOOTP. The BOOTP server must be configured to respond to BOOTP
requests from the target system. If the BOOTP server is unable to
respond or the requested firmware update image does not exist, fwup‐
grade will exit with error status.
You can tell if the SAVE_ENV callback exists by executing the command:
# consvar -a
The SAVE_ENV is supported on the target system if the following message
is displayed: Console environment variables saved
If the SAVE_ENV is not supported on the target system, the following
message is displayed: Failed to save environment variables
Your programs can either check the return status of consvar -a or the
return status of:
setsysinfo(SSI_PROM_SAVE_ENV,...).
See the setsysinfo(2) reference page for more information.
EXIT STATUS
If you confirm that the firmware is to be upgraded, and no errors occur
setting up the upgrade process, then fwupgrade will reboot the system
rather than exit. An exception is that there is no reboot performed
when the -i option is used. Instead, a status of 0 is returned.
If you query whether the process would be successful, or if an upgrade
request fails, the exit values are: Success. Firmware is adequate and
supported. Failure. Firmware is not supported. Firmware needs to
updated (when queried).
EXAMPLES
To find out all information about your current firmware, platform, and
the source firmware: # /sbin/fwupgrade -v -q Current Firmware: 4.10-0
Platform: 17-2-1091 Unable to open smmtable.txt at '/'. What is the
mount point for the firmware CD? /mnt Firmware CD Version: 4.0 Distri‐
bution Firmware: 4.10-0 LFU File: /dev/rz2a at
alpha1000/as1000_e4_v4_8.exe LFU Support: Y Soft Reset: Y System
Firmware does not need to be upgraded To upgrade the firmware: #
./fwupgrade -t /mnt Current Firmware: 4.7-0 Are you sure that you wish
to update the system firmware from 4.7-0 to 4.10-0?(yes/no)yes
fwupgrade:Rebooting to update the system firmware...
Terminated # syncing disks... done rebooting.... (transferring to moni‐
tor) To upgrade the system firmware with the remote firmware update
image t64_fwupdate.exe and network adapter ee0: # ./fwupgrade -n
t64_fwupgrade.exe -d ee0
FILES
The loadable firmware update images. Typically, these are distributed
on a firmware CD-ROM. If you obtain firmware images from a source
other than the firmware CD-ROM (such as a Web server) you should verify
that they are the correct images for the target system. A file pro‐
vided with the firmware CD-ROM, used to determine the presence of the
firmware CD-ROM and information about source firmware.
SEE ALSO
Commands: consvar(8)
Functions: setsysinfo(2)fwupgrade(8)