*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> fwupgrade (8)              



NAME    [Toc]    [Back]

       fwupgrade  -  Updates  the system firmware from a loadable
       firmware image (*.exe or *.sys)

SYNOPSIS    [Toc]    [Back]

       /sbin/fwupgrade [-a] [-e] [-ignore] [-q]  [-r]  [-s]  [-v]
       [-t CD-ROM_path] [-i path]

       /sbin/fwupgrade [-v] -f firmware_filename

OPTIONS    [Toc]    [Back]

       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 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  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  confirmation  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    [Toc]    [Back]

       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, fwupgrade 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

       If the SAVE_ENV is not supported on the target system, the
       following message is displayed: Failed to save environment

       Your programs  can  either  check  the  return  status  of
       consvar -a or the return status of:


       See the setsysinfo(2) reference page for more information.

EXIT STATUS    [Toc]    [Back]

       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    [Toc]    [Back]

       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 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)  To upgrade the system firmware with
       the remote firmware update image t64_fwupdate.exe and network
  adapter  ee0:  # ./fwupgrade -n t64_fwupgrade.exe -d

FILES    [Toc]    [Back]

       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  provided  with
       the firmware CD-ROM, used to determine the presence of the
       firmware CD-ROM and information about source firmware.

SEE ALSO    [Toc]    [Back]

       Commands: consvar(8)

       Functions: setsysinfo(2)

[ Back ]
 Similar pages
Name OS Title
consvar Tru64 Manipulate system firmware console environment variables
uyap OpenBSD USB YAP phone firmware loader
bios OpenBSD a driver for PC Firmware, aka BIOS
efi HP-UX Extensible Firmware Interface description
pdc HP-UX processor-dependent code (firmware)
epfirm IRIX maintain E-Plex 8-port Ethernet Firmware
fgen NetBSD IEEE 1275 Open Firmware FCode Tokenizer
fgen OpenBSD IEEE 1275 Open Firmware FCode Tokenizer
bt3cfw FreeBSD firmware download utility for 3Com Bluetooth PC card driver
ubtbcmfw FreeBSD Firmware driver for Broadcom BCM2033 chip based Bluetooth USB devices
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service