NAME
dsp — display status of an HP SCSI disk array
SYNOPSIS
dsp -p
[-h|-d]
device_file
dsp -l
[-h|-d]
device_file
DESCRIPTION
dsp
displays the status of the
LUN
(in an
HP SCSI
disk array) that is associated with the device file
device_file.
dsp
displays the status of physical drives in an array
(when the
-p
option is specified), or the
status of
LUNs in an array (when the
-l
option is specified).
This information can be displayed in interpreted form, or
in raw hexadecimal or raw decimal format.
Options
- -p
Display physical drive status. The
-p
option displays the status of a
LUN's
physical drives, regardless of their
LUN
ownership. This information is retrieved the array physical
page (Mode Page 2A), and inquiry data.
- -l
Display
LUN
status. The
-l
option displays information about the state of the
LUN
including it's
RAID
level, block and segment sizes, reconstruction information, and so on.
This information is retrieved from the array logical page
(Mode Page 2B), and inquiry data.
By default, data is displayed in interpreted form; if
raw data is desired, one of the following options can be used:
- -h
Raw hex format. Displays the data in raw hex format in rows, each of which
contains the
ASCII
representation of 16 hexadecimal data bytes, separated by spaces.
- -d
Raw decimal format. Displays the data in raw decimal format in rows,
each of which contains the
ASCII
representation of 16 decimal data bytes, separated by spaces.
RETURN VALUE
dsp
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 dsp:
- usage: dsp <-p | -l> [-h | -d] <special>
An error in command syntax has occurred.
Enter the command again with all required arguments.
- dsp: Arg out of range
One of the arguments is larger than its allowed maximum value
(or smaller than its allowed minimum value),
or is incorrect in form. Check the size and form of each argument
and make appropriate corrections.
- dsp: LUN # too big
The
LUN
number, which is derived from the device special file name, is
out of range.
- dsp: Not a raw file
Utilities must be able to open the device file for raw access.
- dsp: Transfer length error
The amount of data actually sent to or received from the device was
not the expected amount.
- dsp: LUN does not exist
The requested
LUN
is not among those known to the controller.
- dsp: Not an HP SCSI disk array
The device being addressed is not an
HP SCSI
disk array.
SCSI (device level) communication errors:
Sense data associated with the failed operation is printed.
Error messages generated by system calls:
dsp
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.
dsp
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 status of the drives on the
HP SCSI
disk array
/dev/rdsk/c2t4d0
on a Series 700:
To display the status of the
LUN
associated with the
HP SCSI
disk array
/dev/rdsk/c2t0d0
on a Series 800 in raw hex format:
dsp -l -h /dev/rdsk/c2t0d0
To display the status of the drives on the
HP SCSI
disk array
/dev/rdsk/c2t5d0
in raw decimal format on a Series 700:
dsp -p -d /dev/rdsk/c2t5d0
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 runing HP-UX
versions 9.0X and 10.0X.
AUTHOR
dsp
was developed by
HP.