sg_turs(8)

1SG_TURS(8)                         SG3_UTILS                        SG_TURS(8)
2
3
4

NAME

6       sg_turs - send one or more SCSI TEST UNIT READY commands
7

SYNOPSIS

9       sg_turs   [--help]  [--number=NUM]  [--progress]  [--time]  [--verbose]
10       [--version] DEVICE
11
12       sg_turs [-n=NUM] [-p]  [-t] [-v] [-V] DEVICE
13

DESCRIPTION

15       This utility sends one or more SCSI TEST UNIT  READY  commands  to  the
16       DEVICE.  This  may be useful for timing the per command overhead.  Note
17       that TEST UNIT READY has no associated data, just a 6 byte command  and
18       a  returned SCSI status value. If the SCSI status value is CHECK CONDI‐
19       TION then most modern initiators fetch sense data from the device (i.e.
20       autosense).
21
22       This  utility  supports two command line syntaxes, the preferred one is
23       shown first in the synopsis and explained in this section. A later sec‐
24       tion  on  the  old  command  line  syntax  outlines the second group of
25       options.
26

OPTIONS

28       Arguments to long options are mandatory for short options as well.
29
30       -h, --help
31              print out the usage message then exit.
32
33       -n, --number=NUM
34              performs TEST UNIT READY NUM times. If not given defaults to  1.
35              These  suffix  multipliers  are  permitted:  c C *1; w W *2; b B
36              *512; k K  KiB  *1,024;  KB  *1,000;  m  M  MiB  *1,048,576;  MB
37              *1,000,000; g G GiB *1,073,741,824; and GB *1,000,000,000 . Also
38              a suffix of the form "x<n>" multiplies  the  leading  number  by
39              <n>. Alternatively a hex number may be given, prefixed by either
40              '0x' or has a trailing 'h'.
41
42       -O, --old
43              switch to older style options.
44
45       -p, --progress
46              show progress indication (a percentage) if available.  If --num‐
47              ber=NUM is given and NUM is greater than 1 then waits 30 seconds
48              before subsequent checks. Exits when NUM is reached or there  is
49              no more progress indication. Ignores --time option.
50
51       -t, --time
52              after  completing  the  requested number of TEST UNIT READY com‐
53              mands, outputs the total duration and the average number of com‐
54              mands executed per second.
55
56       -v, --verbose
57              increase level or verbosity.
58
59       -V, --version
60              print version string then exit.
61

EXIT STATUS

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

OLDER COMMAND LINE OPTIONS

67       The options in this section were  the  only  ones  available  prior  to
68       sg3_utils  version  1.23  .  In  sg3_utils version 1.23 and later these
69       older options can be selected by either setting the  SG3_UTILS_OLD_OPTS
70       environment variable or using '--old' (or '-O) as the first option.
71
72       -n=NUM performs  TEST UNIT READY NUM times. If not given defaults to 1.
73              Equivalent to --number=NUM in the main description.
74
75       -N     switch to the newer style options.
76
77       -p     show progress indication (a percentage) if  available.   Equiva‐
78              lent to --progress in the main description.
79
80       -t     after  completing  the  requested number of TEST UNIT READY com‐
81              mands, outputs the total duration and the average number of com‐
82              mands  executed  per  second.   Equivalent to --time in the main
83              description.
84
85       -v     increase level of verbosity.
86
87       -V     print out version string then exit.
88

AUTHORS

90       Written by D. Gilbert
91

COPYRIGHT

93       Copyright © 2000-2006 Douglas Gilbert
94       This software is distributed under the GPL version 2. There is NO  war‐
95       ranty;  not  even  for MERCHANTABILITY or FITNESS FOR A PARTICULAR PUR‐
96       POSE.
97