dlf - download firmware to an HP SCSI disk array
dlf -f firmware_file device_file
dlf downloads a new set of controller firmware to the HP SCSI disk
array associated with device file device_file. The firmware_file must
be a binary file with a special format.
dlf returns the following values:
0 Successful completion.
-1 Command failed (an error occurred).
Errors can originate from problems with:
+ SCSI (device level) communications
+ system calls
Error messages generated by dlf:
usage: dlf -f <<<<firmware file>>>> <<<<special>>>>
An error in command syntax has occurred. Enter command again
with all required arguments, in the order shown.
dlf: Binary file has bad format
The binary file could not be read in properly by the utility.
dlf: device busy
To ensure that dlf does not modify a disk array that is being
used by another process, dlf attempts to obtain exclusive access
to the disk array. If the disk array is already opened by
another process (for example, LVM - the Logical Volume Manager),
a ``device busy'' error message is returned by the driver. To
eliminate the ``device busy'' condition, determine what process
has the device open. In the case of LVM, it is necessary to
deactivate the volume group containing the array before
configuring the array (see vgchange(1M)).
dlf: LUN # too big
The LUN number, which is derived from the device file name, is
out of range.
dlf: Not a raw file
Utilities must be able to open the device file for raw access.
Hewlett-Packard Company - 1 - HP-UX Release 11i: November 2000
dlf: Not an HP SCSI disk array
The device being addressed is not an
dlf: Transfer length error
The amount of data actually sent to or received from the device
was not the expected amount. HP SCSI disk array.
SCSI (device level) communication errors:
Sense data associated with the failed operation is printed.
Error messages generated by system calls:
dlf uses the following system calls:
malloc(), free(), stat(), open(), close(), fopen(), fclose(),
read(), write(), and ioctl().
Documentation for these HP-UX system calls contains information about
the specific error conditions associated with each call. dlf does not
alter the value of errno. The interpretation of errno for printing
purposes is performed by the system utility strerror().
To download the special-format binary file new_firmware to the HP SCSI
disk array /dev/rdsk/c2t0d0 on a series 800:
dlf -f new_firmware /dev/rdsk/c2t0d0
The HP C2425 and HP C2427 disk arrays are only supported on Series 700
systems running HP-UX version 9.0X.
The HP C2430 disk array is supported on Series 700 and 800 systems
running HP-UX versions 9.0X and 10.0X.
dlf was developed by HP.
Hewlett-Packard Company - 2 - HP-UX Release 11i: November 2000