NAME

see − access bytes in the HP SCSI disk array controller EEPROM

SYNOPSIS

see -d special

see -b byte_number -h hex_byte device_file

DESCRIPTION

see displays, or changes bytes in the controller EEPROM of the HP SCSI disk array associated with device file device_file. A 64-byte area in the EEPROM is accessible to the user. Although the command is directed to a single LUN, the EEPROM settings affect all the LUNs of the device.

Options

-d Display only.  Displays the current values of the bytes in the accessible portion of the EEPROM. 

-b byte_number -v hex_byte
Loads the hexadecimal value hex_byte into the decimal byte byte_number of the user accessible 64-byte region in the EEPROM. 

BYTE DESCRIPTION

The following list of user accessible bytes in the EEPROM, and their default values is provided for informational purposes only.  Changing the values can result in "incorrect" controller behavior with respect to HP SCSI disk array utilities, and other support software.  See WARNINGS. 

RETURN VALUE

see returns the following values:

0 Successful completion. 

-1 Command failed (an error occurred). 

DIAGNOSTICS AND ERRORS

Errors can originate from problems with:

• see

• SCSI (device level) communications

• system calls

Error messages generated by see:

usage: see <-d | -b <byteno> -v <hex byte>> <special>
An error in command syntax has occurred. Re-enter command with the required arguments, in the order shown.

see: Arg out of range
One of the arguments has exceeded its maximum or minimum size, or is incorrect in form. Check the size and form of each argument.

see: device busy
To ensure that see does not modify a disk array that is being used by another process, see 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)). 

see: LUN # too big
The LUN number, which is derived from the device special file name, is out of range.

see: LUN does not exist
The addressed LUN is not configured, and thus is not known to the array controller.

see: Not a raw file
Utilities must be able to open the device file for raw access.

see: Not an HP SCSI disk array
The device being addressed is not an HP SCSI disk array.

see: Transfer length error
The amount of data actually sent to or received from the device was not the expected amount.

SCSI (device level) communication errors:

Sense data associated with the failed operation is printed. 

Error messages generated by system calls:

see uses the following system calls:

stat(), open(), close(), read(), write(), and ioctl(). 

Documentation for these HP-UX system calls contains information about the specific error conditions associated with each call.  see does not alter the value of errno.  The interpretation of errno for printing purposes is performed by the system utility strerror(). 

EXAMPLES

To display the values of the accessible EEPROM bytes on HP SCSI disk array /dev/rdsk/c2t6d0 on a Series 700:

see -d /dev/rdsk/c2t6d0

WARNING

Changing the values of EEPROM bytes can result in incorrect controller behavior with respect to utilities and support software that may not be immediately obvious.  Also, the EEPROM can only be written to a finite number of times, and if its write count is exceeded, it must be replaced. 

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

see was developed by HP. 

Hewlett-Packard Company  —  HP-UX Release 10.20:  July 1996