sg_turs

Langue: en

Autres versions - même langue

Version: 51988 (openSuse - 09/10/07)

Section: 8 (Commandes administrateur)

Sommaire

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. If the SCSI status value is CHECK CONDITION then most modern initiators fetch sense data from the device (i.e. autosense).

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 and NUM is greater than 1 then waits 30 seconds before subsequent checks. Exits when NUM is reached or there is no more progress indication. Ignores --time option.
-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.

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 © 2000-2006 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(sg3_utils)