Unix‎ > ‎Solaris‎ > ‎Solaris man pages‎ > ‎1m‎ > ‎

fwflash


NAME
     fwflash - firmware query and update utility

SYNOPSIS
     /usr/sbin/fwflash  [-l [-c device_class | ALL ]]
         | [-v] | [-h]


     fwflash  [-f file | -r file]
         [-y] [-d dev_spec]


DESCRIPTION
     The fwflash command writes a binary image file to flash dev-
     ices  of  an HBA or HCA device. It also provides the ability
     to read firmware to a  file  if  supported  by  the  device.
     Because  changing the firmware in a device can have signifi-
     cant impact on the stability of a system,  only  users  with
     the privilege All are allowed to execute this command. Users
     authorized to run fwflash can be granted the "Firmware Flash
     Update" Rights Profile.


     The first form of the command, above,  provides  information
     about  devices.  It lists all devices currently available on
     the system and supported by fwflash  for  firmware  upgrade.
     You can filter the list operation, to display only specified
     classes of devices. The second form of the command  provides
     the  operations  to  read  or  write  the firmware images to
     specific devices.

OPTIONS
     The following options are supported:

     -c device_class

         An optional parameter, valid only when used with the  -l
         option. This option causes the command to list only dev-
         ices of  a  specific  class  type.  Currently  supported
         classes  are  IB  or ALL. If -c is not specified for the
         -loption, the class defaults to ALL.


     -d dev_spec

         The dev_spec is an identifier of  the  device  that  the
         user  wants  to  modify  with  the  -for  -r  operation.
         dev_spec  can  be  either  the  absolute  path  name  as
         displayed in the -l listing or as the device number from
         the same listing. If the device  cannot  be  found,  the
         command fails.

     -f file

         Specify the path to a binary firmware file you  want  to
         write  to  the device. fwflash will verify that the file
         is a valid firmware binary for the  dev_spec  specified.
         If  it  is  not,  the  command fails with an appropriate
         error message.


     -h

         List the command line help for fwflash.


     -l

         List the devices on  a  system  available  for  firmware
         upgrade  and display information specific to each device
         or device class.

         For  InfiniBand  (IB)  devices,   the   list   operation
         displays   the   guids   (Globally   Unique  Identifier)
         currently set for  the  HCA,  as  well  as  the  current
         firmware  revision  installed.  There  are four separate
         guids on the HCA; two of them can be set with  the  same
         value.


     -r file

         Specify the path to a file to create  when  reading  the
         firmware  from  the  device.  The  -f and -r options are
         mutually exclusive.


     -v

         Output fwflash version information and exit.


     -y

         Valid during an -f or -r operation, causes  fwflash  not
         to  prompt for confirmation during operation and operate
         non-interactively.


EXAMPLES
     Example 1 Entering Command Without Arguments



     The following command shows  fwflash  when  the  command  is
     entered without arguments.


       example# fwflash
       Usage: fwflash [-l [-c <device_class> | ALL]] | [-v] | [-h]
                     [-f <file> | -r <file>]  [-y] [-d <dev_spec>]



     Example 2 Listing Devices Available to Flash


     The following command lists  the  devices  available  to  be
     flashed.


       example# fwflash -l
       List of available devices:
       Device[0],  /devices/pci@0,0/pci8086,3595@2/pci8086,32a@0,2/\
                  pci15b3,5a46@c/pci15b3,5a44@0:devctl
          Class [IB]
              GUID: System Image - 0002c901081e33b3
                    Node         - 0000000000003446
                    Port 1       - 0002c901081e33b1
                    Port 2       - 0002c901081e33b2
              Firmware revision: 3.3.0002
              No HW information available

       Device[1],  /devices/pci@0,0/pci8086,3597@4/pci15b3,6278@0:devctl
          Class [IB]
              GUID: System Image - 0002c9010a99e3b3
                    Node         - 0002c9010a99e3b0
                    Port 1       - 0002c9010a99e3b1
                    Port 2       - 0002c9010a99e3b2
              Firmware revision: 4.8.00c8
              Product           : MTLP25208-CF256T (Lion cub)
              PSID              : MT_00B0000001



     Example 3 Flash Upgrading an IB HCA Device


     The following command flash upgrades an IB HCA device.


       example# fwflash -f ./version.3.2.0000 -d 0
       About to update firmware on:
        /devices/pci@1d,700000/pci@1/pci15b3,5a44@0:devctl
       Continue (Y/N): Y

       Updating . . . . . . . . . . . .
       Done.  New image will be active after the system is rebooted.




     Note that you are prompted before the upgrading proceeds.



     The following command adds the -y option  to  the  preceding
     command.


       example# fwflash -y -f ./version.3.2.0000 -d 0
       About to update firmware on:
        /devices/pci@1d,700000/pci@1/pci15b3,5a44@0:devctl

       Updating . . . . . . . . . . . .
       Done.  New image will be active after the system is rebooted.



     Example 4 Reading Device Firmware to File


     The command shown below reads the device firmware to a file.
     The  command  uses the -y option so that read occurs without
     prompting.


       example# fwflash -y -r /firmware.bin -d 1
       About to read firmware on:
               /devices/pci@0,0/pci8086,3596@3/pci15b3,6278@0:devctl
       to filename: /firmware.bin

       Reading . . .
       Done.



RETURN VALUES
     The fwflash command returns the following values:

     0

         Success


     1

         Failure

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWfwflash                 |
    |_____________________________|_____________________________|


SEE ALSO
     attributes(5), tavor(7D)

NOTES
     The fwflash command supports IB class HCA  cards  containing
     either  the  AMD  or  the  Intel  parallel  flash parts. The
     tavor(7D) HCA driver is required.










Man pages from Solaris 10 Update 8. See docs.sun.com and www.oracle.com for further documentation and Solaris information.
Comments