GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  SG_TURS (8)

NAME

sg_turs - send one or more SCSI TEST UNIT READY commands

CONTENTS

Synopsis
Description
Options
Notes
Exit Status
Older Command Line Options
Authors
Copyright

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).

The DEVICE is opened with a read-only flag (e.g. in Unix with the O_RDONLY flag).

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 (e.g. in the case of a mechanical disk, it is spun up and ready to accept commands). For this utility the other exit status of interest is 2 corresponding to the "not ready" sense key. For other exit status values 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-2014 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)
Search for    or go to Top of page |  Section 8 |  Main Index


sg3_utils-1.39 SG_TURS (8) May 2014

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.