sg_read_buffer - send a SCSI READ BUFFER command
sg_read_buffer [--help] [--hex] [--id=ID] [--length=LEN] [--mode=MO] [--offset=OFF] [--raw] [--verbose] [--version] DEVICE
SG_READ_BUFFER(8) SG3_UTILS SG_READ_BUFFER(8)
NAME
sg_read_buffer - send a 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 "allo-
cation 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 abbrevia-
tion 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.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+---------------+--------------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+--------------------------+
|Availability | system/storage/sg3_utils |
+---------------+--------------------------+
|Stability | Uncommitted |
+---------------+--------------------------+
NOTES
All numbers given with options are assumed to be decimal. Alterna-
tively 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-2011 Luben Tuikov and Douglas Gilbert
This software is distributed under a FreeBSD license. There is NO war-
ranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PUR-
POSE.
SEE ALSO
sg_write_buffer(sg3_utils)
This software was built from source available at
https://java.net/projects/solaris-userland. The original community
source was downloaded from http://sg.danny.cz/sg/p/sg3_utils-1.33.tgz
Further information about this software can be found on the open source
community website at http://sg.danny.cz/sg/sg3_utils.html.
sg3_utils-1.31 February 2011 SG_READ_BUFFER(8)