sg_read_buffer
(1m)
名前
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
説明
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 "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. Alterna-
tively 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.
sg3_utils-1.31 Last change: February 2011 1
SG3_UTILS SG_READ_BUFFER(8)
-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.
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 success-
ful. 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 warranty; not even for MERCHANTABILITY or FITNESS FOR
A PARTICULAR PURPOSE.
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
sg3_utils-1.31 Last change: February 2011 2
SG3_UTILS SG_READ_BUFFER(8)
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 Last change: February 2011 3