*** UNIX MANUAL PAGE BROWSER ***

fwupgrade(8) System Manager's Manual fwupgrade(8) NAME fwupgrade - 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 FLAGS Forces a firmware update without comparing the current firmware with the source firmware. 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 distribution CD-ROM. For example, an image obtained from a web site download. 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 tar- get disk during an installation. This switch is to be used exclusively by the Digital UNIX install program. This switch suppresses error mes- sages that are displayed if no firmware files are found on the distrib- ution media, and causes the fwupgrade program to exit successfully. Does not upgrade the firmware, but displays information about the suc- cess 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 up- grade. The utility will exit with an error status if the system hard- ware 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 confirmation for the upgrade to proceed. Specifies the path of the mounted Firmware CD. If the -s flag 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 Al- pha SRM. 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 fol- lowing 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 setsys- info(2) reference page for more information. 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 Distrib- ution Firmware: 4.10-0 LFU File: /dev/rz2a at al- pha1000/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) EXIT VALUES 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 flag 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: 0 Success. Firmware is adequate and supported 1 Failure. Firmware is not supported 2 Firmware needs to up- dated (when queried) FILES The loadable firmware update images provided by Digital. Typically, these are distributed on a firmware CD-ROM. If you obtain firmware im- ages from a source other than the firmware CD-ROM (such as a www server) you should verify that they are the correct images for the tar- get system. A file provided with the firmware CD-ROM, used to deter- mine the presence of the firmware CD-ROM and information about source firmware. RELATED INFORMATION consvar(8), setsysinfo(2) delim off delim off fwupgrade(8)