SCSI_READCAP(8) SG3_UTILS SCSI_READCAP(8)NAME
scsi_readcap - do SCSI READ CAPACITY command on disks
SYNOPSIS
scsi_readcap [--brief] [--help] [--long] [--verbose] DEVICE [DEVICE]*
DESCRIPTION
This bash shell script calls the sg_readcap utility on each given DEVICE. This will send a SCSI READ CAPACITY command to each DEVICE.
The default action of this script is to send the 10 byte cdb READ CAPACITY(10) command to each DEVICE. If a response indicates the number
of blocks is greater than or equal to '2**32 - 1' then the READ CAPACITY(16) is sent and its response is output.
OPTIONS
Arguments to long options are mandatory for short options as well.
-b, --brief
shortens the output to two hexadecimal numbers, both prefixed by '0x'. The first number is the number of blocks available and the
second is the size of each blocks in bytes (e.g. '0x12a19eb0 0x200'). If an error is detected '0x0 0x0' is output and the script
continues if there are more DEVICEs.
-h, --help
print out the usage message then exit.
-l, --long
the default is to send the READ CAPACITY(10) command (i.e. the 10 byte cdb variant). When this option is given the READ CAPACITY(16)
command is sent. The latter command yields more information in its response.
-v, --verbose
increase level or verbosity.
EXIT STATUS
The exit status of this script is 0 when it is successful. Otherwise the exit status is that of the last sg_readcap utility called. See the
sg3_utils(8) man page.
AUTHORS
Written by D. Gilbert
COPYRIGHT
Copyright (C) 2009-2013 Douglas Gilbert
This software is distributed under a FreeBSD license. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PUR-
POSE.
SEE ALSO
sg_readcap (sg3_utils)
sg3_utils-1.36 May 2013 SCSI_READCAP(8)
Check Out this Related Man Page
SG_READ_BUFFER(8) SG3_UTILS SG_READ_BUFFER(8)NAME
sg_read_buffer - send SCSI READ BUFFER command
SYNOPSIS
sg_read_buffer [--help] [--hex] [--id=ID] [--length=LEN] [--mode=MO] [--offset=OFF] [--raw] [--verbose] [--version] DEVICE
DESCRIPTION
Sends a SCSI READ BUFFER command to the DEVICE, and if there is a response either decodes it, prints it in hexadecimal or sends it in
binary to stdout. If a response is received for a "descriptor" mode then, in the absence of --hex and --raw, it is decoded. Response for
non-descriptor modes are output in hexadecimal unless the --raw option is given.
OPTIONS
Arguments to long options are mandatory for short options as well.
-h, --help
output the usage message then exit. If used multiple times also prints the mode names and their acronyms.
-H, --hex
output the response in hexadecimal. When given twice the response is output in hex with the corresponding representation in ASCII to
the right of each line.
-i, --id=ID
this option sets the buffer id field in the cdb. ID is a value between 0 (default) and 255 inclusive.
-l, --length=LEN
where LEN is the length, in bytes, that is placed in the "allocation length" field in the cdb. The default value is 4 (bytes). The
device may respond with less bytes.
-m, --mode=MO
this option sets the mode field in the cdb. MO is a value between 0 (default) and 31 inclusive. Alternatively an abbreviation can be
given. To list the available mode abbreviations use an invalid one (e.g. '--mode=xxx'). As an example, to fetch the read buffer
descriptor give '--mode=desc' .
-o, --offset=OFF
this option sets the buffer offset field in the cdb. OFF is a value between 0 (default) and 2**24-1 . It is a byte offset.
-r, --raw
if a response is received then it is sent in binary to stdout.
-v, --verbose
increase the level of verbosity, (i.e. debug output).
-V, --version
print the version string and then exit.
NOTES
All numbers given with options are assumed to be decimal. Alternatively numerical values can be given in hexadecimal preceded by either
"0x" or "0X" (or has a trailing "h" or "H").
EXIT STATUS
The exit status of sg_read_buffer is 0 when it is successful. Otherwise see the sg3_utils(8) man page.
AUTHORS
Written by Luben Tuikov and Douglas Gilbert.
REPORTING BUGS
Report bugs to <dgilbert at interlog dot com>.
COPYRIGHT
Copyright (C) 2006-2012 Luben Tuikov and Douglas Gilbert
This software is distributed under a FreeBSD license. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PUR-
POSE.
SEE ALSO
sg_write_buffer(sg3_utils)
sg3_utils-1.35 November 2012 SG_READ_BUFFER(8)