dteststat - display the results of disk testing, or cancel the test.
dteststat [-D slot] [-?] array-id
dteststat -D slot -c [-?] array-id
dteststat displays the results of testing performed on the indicated
disk in the disk array identified by array-id. A test in progress can
also be canceled using dteststat. Disk testing is initiated using the
The array-id used to address the disk array can be the disk array
serial number, the character device file name of any LUN on the array
(LUN 0 if no LUNs are created), or the alias text string assigned to
the disk array.
dteststat supports the following options:
none Display results for all disks being tested. Tests
results are shown for disks that have completed
testing, and progress is shown for tests still
-c Cancel the test currently in progress on the indicated
disk. A test can be canceled on only one disk at a
time, so the -D option must be included when canceling
-D slot Display test results for the disk installed in the
cabinet slot identified by slot. Slot numbers must be
of the form An or Bn, where A or B correspond to a
cabinet column, and n corresponds to a shelf position
-? Display expanded usage message. This option overrides
LC_MESSAGES determines the language in which messages are displayed.
The current language settings can be checked with locale(1).
dteststat returns the following values:
0 Successful completion.
- 1 - Formatted: August 2, 2006
1 An error in execution (I/O, subsystem, security, etc.)
2 An error in command syntax occurred: for example, an unknown
command-line option was passed.
3 Timeout in communication to server. May indicate the ARMServer
is not running.
The following messages can be generated by dteststat:
Usage: dteststat [-D slot] [-c] array-id
An error in command syntax has occurred. Re-enter the command
with all necessary arguments.
dteststat: 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.
dteststat: Unknown argument
An invalid argument was specified. Check command usage.
dteststat: No such file or directory
The specified array-id does not exist or does not identify a disk
array that is communicating with the system. Verify the correct
array-id with ioscan(1M) or arraydsp(1M).
dteststat: Error in command execution, <<<<Additional Error Info>>>>:
<<<<Error Info Decode>>>>
The command failed due to a device error, an internal error, or a
system error. The Additional Error Info and Error Info Decode
fields will hold specifics about the failure and its cause.
dteststat: Array was just powered-on or reset.
The command failed because the disk array has been powered-on or
reset. Reissue the command and it should succeed.
Display the results of the test performed on the disk installed in
slot B3 of the disk array identified by device file /dev/rdsk/c2t0d0:
dteststat -D B3 /dev/rdsk/c2t0d0
Display the results of the tests performed on all disks installed in
the disk array identified by alias AUTORAID1:
Cancel a test currently in progress on the disk installed in slot A1
of disk array serial number 00786b5c0000:
- 2 - Formatted: August 2, 2006
dteststat -D A1 -c 00786b5c0000
ARMServer must be running to execute this command. See ARMServer(1M).
This command is modified for all security configurations.
Use of this command is restricted to authorized users only.
This command requires the sysadmin authorization to successfully
The command has been modified to support least privilege. The
potential privileges possessed by the command and their uses include:
allowdacread This privilege is raised to provide discretionary
read access to the devices.
allowdacwrite This privilege is raised to provide discretionary
write access to the devices.
allowmacread This privilege is raised to provide mandatory read
access to the devices.
allowmacwrite This privilege is raised to provide mandatory
write access to the devices.
filesysops This privilege is raised to allow the mknod(2)
system call to succeed.
writeaudit The command generates its own audit records and
submits these directly to the system audit trail.
This privilege is raised whenever the command
needs to write an audit record.
dteststat was developed by HP.
ARMServer(1M), arraycfg(1M), arraydsp(1M), arrayfmt(1M), arraylog(1M),
arraymgr(1M), arrayrbld(1M), arrayrecover(1M), download(1M),
- 3 - Formatted: August 2, 2006