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)