SG_TURS(8)							     SG3_UTILS								SG_TURS(8)

NAME

       sg_turs - send one or more SCSI TEST UNIT READY commands

SYNOPSIS

       sg_turs [--help] [--number=NUM] [--progress] [--time] [--verbose] [--version] DEVICE

       sg_turs [-n=NUM] [-p]  [-t] [-v] [-V] DEVICE

DESCRIPTION

       This  utility  sends one or more SCSI TEST UNIT READY commands to the DEVICE. This may be useful for timing the per command overhead.  Note
       that TEST UNIT READY has no associated data, just a 6 byte command and a returned SCSI status value.

       This utility supports two command line syntaxes, the preferred one is shown first in the synopsis and explained in this	section.  A  later
       section on the old command line syntax outlines the second group of options.

OPTIONS

       Arguments to long options are mandatory for short options as well.

       -h, --help
	      print out the usage message then exit.

       -n, --number=NUM
	      performs TEST UNIT READY NUM times. If not given defaults to 1.  These suffix multipliers are permitted: c C *1; w W *2; b B *512; k
	      K KiB *1,024; KB *1,000; m M MiB *1,048,576; MB *1,000,000; g G GiB *1,073,741,824; and GB *1,000,000,000 . Also	a  suffix  of  the
	      form "x<n>" multiplies the leading number by <n>. Alternatively a hex number may be given, prefixed by either '0x' or has a trailing
	      'h'.

       -O, --old
	      switch to older style options.

       -p, --progress
	      show progress indication (a percentage) if available. If --number=NUM is given, NUM is greater than 1 and an initial progress  indi-
	      cation  was  detected  then  this utility waits 30 seconds before subsequent checks.  Exits when NUM is reached or there are no more
	      progress indications.  Ignores --time option. See NOTES section below.

       -t, --time
	      after completing the requested number of TEST UNIT READY commands, outputs the total duration and the  average  number  of  commands
	      executed per second.

       -v, --verbose
	      increase level or verbosity.

       -V, --version
	      print version string then exit.

NOTES

       The  progress  indication is optionally part of the sense data. When a prior command that takes a long time to complete (and typically pre-
       cludes other media access commands) is still underway, the progress indication can be used to determine how long before the device  returns
       to its normal state.

       The  SCSI  FORMAT  command  for disks used with the IMMED bit set is an example of an operation that takes a significant amount of time and
       precludes other media access during that time. The IMMED bit set instructs the FORMAT command to return control to the  application  client
       once the format has commenced (see SBC-3). Several long duration SCSI commands associated with tape drives also use the progress indication
       (see SSC-3).

       Early standards suggested that the SCSI TEST UNIT READY command be used for polling the progress indication. More recent standards seem	to
       suggest the SCSI REQUEST SENSE command should be used instead.

EXIT STATUS

       The exit status of sg_turs is 0 when it is successful. Otherwise see the sg3_utils(8) man page.

OLDER COMMAND LINE OPTIONS

       The  options in this section were the only ones available prior to sg3_utils version 1.23 . In sg3_utils version 1.23 and later these older
       options can be selected by either setting the SG3_UTILS_OLD_OPTS environment variable or using '--old' (or '-O) as the first option.

       -n=NUM performs TEST UNIT READY NUM times. If not given defaults to 1.  Equivalent to --number=NUM in the main description.

       -N     switch to the newer style options.

       -p     show progress indication (a percentage) if available.  Equivalent to --progress in the main description.

       -t     after completing the requested number of TEST UNIT READY commands, outputs the total duration and the  average  number  of  commands
	      executed per second.  Equivalent to --time in the main description.

       -v     increase level of verbosity.

       -V     print out version string then exit.

AUTHORS

       Written by D. Gilbert

COPYRIGHT

       Copyright (C) 2000-2008 Douglas Gilbert
       This  software  is distributed under the GPL version 2. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PUR-
       POSE.

SEE ALSO

       sg_inq, sg_request (sg3_utils)

sg3_utils-1.26							    March 2008								SG_TURS(8)