Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   26626 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

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.

       -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
	      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.  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 © 2006-2007 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)

sg3_utils-1.23			 January 2007		     SG_READ_BUFFER(8)

Vote for polarhome