lsflash(1m)lsflash(1m)NAMElsflash - Download firmware to LS boards
SYNOPSIS
/usr/sbin/lsflash fwfile ctlr
DESCRIPTIONlsflash downloads firmware to LSI boards. On boards which have multiple
functions, only one function needs to be downloaded. After a successful
download, all functions on the board will be restarted to begin executing
the new firmware and the functions will be reprobed.
fwfile is the full pathname/filename to the firmware file.
ctlr is the number of the controller to download. /hw/scsi_ctlr and bus
will be added. If a full pathname from / is used for the argument, it
will be used unmodified as the controller filename.
The default firmware files will be found in the /usr/firmware/ls
directory. Naming will follow the convention of ls<chip number>.fw.
LIMITATIONS
If a bad image is downloaded, the restart will fail. At that point, the
only option is download a good image. Any other operation will return an
error.
Although this program and the device driver make some attempt to verify
the firmware file is correct, the checks are limited. Use care in
selecting the image to download.
Its recommended that all filesystems on the board's targets be unmounted
and the functions idle before issuing this command. This is to prevent
problems during the download and if the download fails. Be sure to
unmount the devices on all board functions.
FILES
/usr/sbin/lsflash
/usr/firmware/ls/ls1030.fw /usr/firmware/ls/ls949.fw
SEE ALSOioconfig(1M), scsicontrol(1M), scsiha(1M), sesmgr(1M)NOTES
You must have CAP_DEVICE_MGMT in addition to privileges on the controller
device file in order to use this command.
IO will be held during an operational download. After the download
completes, IO will resume on a successful restart.
Although a download failure can corrupt the board firmware, it will not
corrupt any data on devices attached to the controller. Tapes may be
repositioned by this operation.
Page 1
lsflash(1m)lsflash(1m)
In the event a board has corrupt firmware at boot, the controllers will
be shown in inventory and their device files will exist. However no
targets will be shown and any attempts to do anything but download
firmware will return an error. Once successfully downloaded, the board
functions will be started and probed. Afterwards, ioconfig will need to
be executed manually, as will sesmgr poll for fibre channel controllers.
When a board has corrupt firmware, a download process must be used which
will not store the firmware image in NVRAM. When this is the case,
lsflash will download the firmware twice; once to get the board running
and a second time to store the image to NVRAM.
In the event that restart fails after the download, target device files
and inventory entries will still be present but devices will be
inaccessible until a successful download takes place.
The Fibre Channel 939 and 949 boards use the same firmware.
Boards which use the 1064 and 1068 chips require firmware versions
specific to the various types of hbas. Use of the wrong firmware file
will render the controller unusable. These files will be made available
on Supportfolio.
Page 2
