NAME¶

sgdskfl - SCSI Disk Firmware Load utility

SYNOPSIS¶

sgdskfl [-aeinrxI -d devname -f imagefile -m diskmodel -t secdelay ]

DESCRIPTION¶

Sgdskfl is a program that uses the SCSI Generic interface to send specific 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 kernel .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

Auto-flash all devices with firmware image files located in the default directory (/usr/share/scsirastools). This expects image filenames formed using the first 8 characters of the model (lower case), with the ".lod" extension. For example: "st39173w.lod"

-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 example: "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 sg device names are used with numeric sequences (/dev/sg0). This option uses the device names as alphabetic sequences (/dev/sga), mainly for older Linux versions.

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

-y

Yes, force the image file to match the disk model. Only specify this option if you are sure that it is the correct firmware image file for this disk, but the scan returned that the model was not found in the image.

-I

Starts the utility in Interactive mode, requiring user input.

SEE ALSO¶

sgdefects(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>