| .TH SG_TURS "8" "April 2005" "sg3_utils-1.14" SG3_UTILS |
| .SH NAME |
| sg_turs \- executes a user specified number of TEST UNIT READY commands on |
| the given device |
| .SH SYNOPSIS |
| .B sg_turs |
| [\fI-n=<number of commands to send>\fR] [\fI-t] [\fI-v] [\fI-V] |
| <\fIscsi_device\fR> |
| .SH DESCRIPTION |
| .\" Add any additional description here |
| .PP |
| sg_turs sends a number of TEST UNIT READY commands to a given SCSI |
| device. 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. |
| .TP |
| -n=<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 0X. |
| .TP |
| -t |
| after completing the requested number of TEST UNIT READY commands, outputs |
| the total duration and the average number of commands executed per second. |
| .TP |
| -v |
| increase level of verbosity: print out SCSI commands in hex prior to |
| sending them to the device. '-vv' and '-vvv' are also accepted yielding |
| greater verbosity. |
| .TP |
| -V |
| print out version string then exit. |
| .SH AUTHORS |
| Written by D. Gilbert |
| .SH COPYRIGHT |
| Copyright \(co 2000-2005 Douglas Gilbert |
| .br |
| This software is distributed under the GPL version 2. There is NO |
| warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. |
