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