Index Index for
Section 8
Index Alphabetical
listing for F
Bottom of page Bottom of
page		 

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


OPTIONS

  -a  Forces a firmware update without comparing the current firmware with
      the source firmware.

  -e  Updates only if the current firmware is not equivalent to the source
      firmware.

  -f firmware_filename
      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.

  -i  Specifies the mount point of the target disk during an installation.
      This switch is to be used exclusively by the Tru64 UNIX install
      program.

  -ignore
      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.

  -q  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.

  -r  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.

  -s  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.

  -t CD-ROM_path
      Specifies the path of the mounted Firmware CD.  If the -s option is not
      specified, you will be prompted to enter this path.

  -v  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.

  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:

  0 (Zero)
	  Success. Firmware is adequate and supported.

  1	  Failure. Firmware is not supported.

  2	  Firmware needs to updated (when queried).


EXAMPLES

   1.  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
	    Distribution 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

   2.  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 monitor)


FILES

  XXX.exe or XXX.sys
      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.

  smmtable.txt
      A file provided 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)

Index Index for
Section 8
Index Alphabetical
listing for F
Top of page Top of
page