HP-UX Reference (11i v1 05/09) - 1M System Administration Commands A-M (vol 3)
d
dlf(1M) dlf(1M)
NAME
dlf - download firmware to an HP SCSI
disk array
SYNOPSIS
dlf -f firmware_file device_file
DESCRIPTION
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.
RETURN VALUE
dlf returns the following values:
0 Successful completion.
-1 Command failed (an error occurred).
ERROR MESSAGES
Errors can originate from problems with:
• dlf
• 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.
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 associ-
ated 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() .
Section 1M−−180 Hewlett-Packard Company − 1 − HP-UX 11i Version 1: September 2005