SG3UTILS                                             SGTURS(1M)



NAME
     sgturs - send one or more SCSI TEST UNIT READY commands

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

     sgturs [-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  pre-
     ferred  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"  multiplies the leading number by
          . 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  indication  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



sg3utils-1.26       Last change: March 2008                    1






SG3UTILS                                             SGTURS(1M)



          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 com-
     plete (and typically precludes 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  IMED  bit
     set  is  an example of an operation that takes a significant
     amount of time and precludes other media access during  that
     time.  The  IMED  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 SC-3).

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

EXIT STATUS
     The exit status of sgturs is 0 when it is successful.  Oth-
     erwise see the sg3utils(1M) man page.

OLDER COMAND LINE OPTIONS
     The options in this section were  the  only  ones  available
     prior  to sg3utils version 1.23 . In sg3utils version 1.23
     and later these older options can be selected by either set-
     ting  the  SG3UTILSOLDOPTS  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



sg3utils-1.26       Last change: March 2008                    2






SG3UTILS                                             SGTURS(1M)



          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 O 2000-2008 Douglas Gilbert
     This software is distributed under the GPL version 2.  There
     is  NO warranty; not even for MERCHANTABILITY or FITNES FOR
     A PARTICULAR PURPOSE.

SEE ALSO
     sginq, sgrequest (sg3utils)

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     
       ATRIBUTE TYPE     ATRIBUTE VALUE
    
     Availability         SUNWsg3utilsu  
    
     Interface Stability  Committed      
    

NOTES
     Source for sg3utils is available on http:/opensolaris.org.





















sg3utils-1.26       Last change: March 2008                    3