unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 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 <&lt&lt&lt;firmware file>&gt&gt&gt; <&lt&lt&lt;special>&gt&gt&gt;
	   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(1M)							     dlf(1M)




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

 EXAMPLES
      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

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

 AUTHOR
      dlf was developed by HP.


















 Hewlett-Packard Company	    - 2 -   HP-UX Release 11i: November 2000