TEST NAME

hds - disk drive test

SYNOPSIS

sh hds.stf

disktest [ -scruvdtelnf ] [ -i n ] [ -p n ] [ -w n ] [ -o option=value ]

DESCRIPTION

The hds.stf script is the shell script that executes the disktest test. The script loops for the length of time specified by the RUNTIME environment variable, executing disktest on any disk drive that it detects on the system.

The disktest test verifies the functionality of disk drives and diskette drives using three subtests: Media, File System, and Asynchronous/Synchronous I/O.

Most disk drives, such as SCSI floppy disks and IPI, are supported. When disktest is run as a part of the Level 1 System Certification tests, only asynchronous I/O is tested. The Level 2 tests stress both asynchronous and synchronous I/O functions.

To test the compatibility of a 32-bit application on a 64-bit system environment, the test run time is divided into two halves during certification. The 64-bit disktest application runs in first half of the test, and the 32-bit disktest application runs in second half of the test.

OPTIONS

-i n
Sets the number of total instances for the test. Default is 1.
-p n
Sets the number of passes for the test to run. Default is 1.
-w n
Specifies the instance this test is assigned. Default is 0.

The following values are set as part of the -o option:

dev=device_name
Specifies the name of the disk to be tested, such as c0t3d0.
partition=0-7
Specifies the partition number to test. A setting of partition=6 means /export/s6, if mounted on partition 6.
rawsub=Enable or rawsub=Disable
Enables or disables the Media subtest.
rawiosize=2KB,16KB,32KB,64KB,128KB,256KB,512KB
Specifies the media size to transfer.
fssub=Enable or fssub=Disable
Enables or disables the File System subtest.
method=AsyncIO or method=SyncIO
Sets the I/O method to synchronous or asynchronous. The default tests both in turn.

SETUP

Before executing hds.stf, specify the length of time it should run (in seconds) by setting the RUNTIME variable. In the following example, the RUNTIME variable is set to 1200 seconds (20 minutes).

# RUNTIME=1200 export RUNTIME

OUTPUT

The hds.stf script outputs PASS or ERROR messages as appropriate, as well as the output from disktest. Throughout testing, disktest displays its status to standard output. The disktest.msg file contains the messages that disktest uses to report its status.

POSSIBLE CONCURRENT TESTS

This test can run concurrently with mcpu, memory, nettest, and rmdtest after the flp test finishes.

EXAMPLES

# sh ./hds.stf
# sh ./disktest -v -o dev=,partition=0,method=AsyncIO

Copyright 2005 Sun Microsystems, Inc. All rights reserved.