← Back to branch summary

~ubuntu-branches/ubuntu/intrepid/sg3-utils/intrepid

« back to all changes in this revision

Viewing changes to sg_turs.8

  • Committer: Bazaar Package Importer
  • Author(s): Luk Claes
  • Date: 2006-11-05 17:23:29 UTC
  • mfrom: (1.1.4 upstream) (3.1.2 edgy)
  • Revision ID: james.westby@ubuntu.com-20061105172329-l4loha00sk36qz6k
http://bugs.debian.org/395512
* Non-maintainer upload.
* Fix FTBFS due to old syscall usage (Closes: #395512).

Show diffs side-by-side

added added

removed removed

Lines of Context:
sg_turs.8
1
 
.TH SG_TURS "8" "April 2003" "sg3_utils-1.03" SG3_UTILS
 
1
.TH SG_TURS "8" "June 2006" "sg3_utils-1.21" SG3_UTILS
2
2
.SH NAME
3
3
sg_turs \- executes a user specified number of TEST UNIT READY commands on
4
4
the given device
5
5
.SH SYNOPSIS
6
6
.B sg_turs
7
 
[\fI-n=<number of commands to send>\fR] [\fI-t]
8
 
<\fIgeneric device\fR>
 
7
[\fI-n=<number of commands to send>\fR] [\fI-p\fR]  [\fI-t\fR] [\fI-v\fR]
 
8
[\fI-V\fR] <\fIscsi_device\fR>
9
9
.SH DESCRIPTION
10
10
.\" Add any additional description here
11
11
.PP
12
12
sg_turs sends a number of TEST UNIT READY commands to a given SCSI
13
 
generic device. Useful for timing the per command overhead. Note that
 
13
device. Useful for timing the per command overhead. Note that
14
14
TEST UNIT READY has no associated data, just a 6 byte command and a
15
15
returned SCSI status value.
16
16
.TP
17
17
-n=<num>
18
18
performs TEST UNIT READY "<num>" times. If not given defaults to 1.
19
 
Postfix multipliers "k" (1024), "K" (1000), "m" (1048576) or "M" (1000000)
20
 
may be applied to "<num>".
 
19
These suffix multipliers are permitted: c C *1; w W *2; b B *512;
 
20
k K KiB *1,024; KB *1,000; m M MiB *1,048,576; MB *1,000,000;
 
21
g G GiB *1,073,741,824; and GB *1,000,000,000 . Also a suffix of the
 
22
form "x<n>" multiplies the leading number by <n>. Alternatively a hex
 
23
number may be given, prefixed by either '0x' or '0X' (or has a
 
24
trailing 'h' or 'H').
 
25
.TP
 
26
-p
 
27
show progress indication (a percentage) if available. If <num> greater
 
28
than one waits 30 seconds before subsequent checks. Exits when <num>
 
29
is reached or there is no more progress indication. Ignores '-t' option.
21
30
.TP
22
31
-t
23
32
after completing the requested number of TEST UNIT READY commands, outputs
24
33
the total duration and the average number of commands executed per second.
 
34
.TP
 
35
-v
 
36
increase level of verbosity: print out SCSI commands in hex prior to
 
37
sending them to the device. '-vv' and '-vvv' are also accepted yielding
 
38
greater verbosity.
 
39
.TP
 
40
-V
 
41
print out version string then exit.
 
42
.SH EXIT STATUS
 
43
The exit status of sg_verify is 0 when it is successful. Otherwise see
 
44
the sg3_utils(8) man page.
25
45
.SH AUTHORS
26
46
Written by D. Gilbert
27
47
.SH COPYRIGHT
28
 
Copyright \(co 2000-2003 Douglas Gilbert
 
48
Copyright \(co 2000-2005 Douglas Gilbert
29
49
.br
30
50
This software is distributed under the GPL version 2. There is NO
31
51
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.