Stress Test: hds.stf

### 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.