Man Linux: Main Page and Category List

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 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 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
       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 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 © 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
       PURPOSE.

SEE ALSO

       sg_inq, sg_request (sg3_utils)