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:
SCSI
(device level) communications
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:
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.