Poster of Linux kernelThe best gift for a Linux geek
SG_READ_BUFFER

SG_READ_BUFFER

Section: SG3_UTILS (8) Updated: January 2007
Local index Up
 

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.
-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 given an invalid one (e.g. '--mode=xxx').
-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 © 2006-2007 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 PURPOSE.  

SEE ALSO

sg_write_buffer(sg3_utils)


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
NOTES
EXIT STATUS
AUTHORS
REPORTING BUGS
COPYRIGHT
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 22:02:21 GMT, April 16, 2011