unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



fwupgrade(8)							 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 pro-
      gram.

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

  -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	con-
      firmation	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 pro-
  vide 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 mes-
  sage 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 provided by Compaq.  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 www
      server) you should verify	that they are the correct images for the tar-
      get system.

  smmtable.txt
      A	file provided with the firmware	CD-ROM,	used to	determine the pres-
      ence of the firmware CD-ROM and information about	source firmware.

SEE ALSO

  Commands: consvar(8)

  Functions: setsysinfo(2)