SGDSKFL(8)SGDSKFL(8)NAMEsgdskfl - SCSI Disk Firmware Load utility
SYNOPSISsgdskfl [-aenrx -d devname -f imagefile -m diskmodel -t secdelay ]
DESCRIPTION
Sgdskfl is a program that uses the SCSI Generic interface to send spe‐
cific SCSI commands to download firmware to disk and tape devices. The
appropriate algorithm is chosen, depending on the vendor and product ID
of each SCSI device. The SCSI Generic interface requires that the ker‐
nel .config file have CONFIG_CHR_DEV_SG set.
A log file, named sgdskfl.log is created in the /var/log directory
which logs the status of the functions and any errors.
Below is the sequence of events for this utility:
* List each device on the system with firmware versions.
* User selects a device for firmware load (automatic if using -m)
* Read the firmware image file for the selected disk and verify
that it is valid.
* Verify that the disk is present and ready
* Close all open files, flush the adapter, sync any data to the
SCSI disks.
* Write the firmware image to the disk using one or more 'write
buffer' SCSI commands.
* Wait 10 (or specified number) seconds before checking for ready
status.
* Verify that the disk comes ready again using SCSI
test_unit_ready commands, and start_unit or scsi_reset to
recover if not.
* If the '-m' or '-a' option was used, repeat writing the firmware
for each specified disk.
OPTIONS
Command line options are described below.
-? This option displays a summary of the commands accepted by
sgdskfl-a Causes the functions to be performed automatically on all con‐
nected SCSI devices.
-d Specify a unix device name. Only perform these functions on the
specified unix device name.
-e Causes any file writes to be avoided, such as the log file.
Usually a log file is created and written to, up until the
firmware download begins on root.
-f Specify this filename for the firmware image. Normally, this
option is not used and the filename is formed using the first 8
characters of the model, with the ".lod" extension. For exam‐
ple: "st39173w.lod". Note that this utility uses the raw
firmware image without any added headers. The utility will look
for the firmware image file first in the current directory, then
in the default directory (/usr/share/scsirastools).
-i N Autorun for the device at Index N, as shown in the 'Num' column.
It will download firmware only to the specified device.
-m Automatically download all drives that match this model string.
-n Naming. By default, the device names are displayed as numeric
sequences (/dev/sg0). This option shows the device names as
alphabetic sequences (/dev/sga).
-r Try to Recover a non-ready drive by updating its firmware. Do
not test if the drive is ready or not beforehand. Use this
option if a drive to be updated returns a sense error.
-t Specifies the number of seconds to delay after the firmware is
written before the program attempts to test if the unit is ready
again. Default is 10 seconds.
-x Causes extra debug messages to be displayed.
SEE ALSOsgdefects(8)sgdiag(8)sgmode(8)WARNINGS
See http://sourceforge.net/projects/scsirastools/ for a bug list and
any later versions of this utility.
COPYRIGHT
Copyright (C) 2001-2002 Intel Corp.
sgdskfl is open source software. You can redistribute it and/or modify
it under the terms of the BSD License. See the COPYING file included
with this software package for more details regarding distribution.
sgdskfl is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY.
AUTHOR
Andy Cress <arcress@users.sourceforge.net>
Version 1.3: 08 May 2002 SGDSKFL(8)