sg_luns(8) [suse man page]

SG_LUNS(8)							     SG3_UTILS								SG_LUNS(8)

NAME

       sg_luns - send the SCSI REPORT LUNS command

SYNOPSIS

       sg_luns [--decode] [--help] [--hex] [--maxlen=LEN] [--quiet] [--raw] [--select=SR] [--verbose] [--version] DEVICE

DESCRIPTION

       Send the SCSI REPORT LUNS command to the DEVICE and outputs the response. In the SPC-3 SCSI standard support for this command is mandatory.

OPTIONS

       Arguments to long options are mandatory for short options as well.

       -d, --decode
	      decode  logical  unit  numbers  into  their hierarchical parts. Interprets luns as described in SAM-3 when the HiSup bit is set in a
	      standard INQUIRY's response.

       -h, --help
	      output the usage message then exit.

       -H, --hex
	      output response to this command in ASCII hex.

       -m, --maxlen=LEN
	      where LEN is the (maximum) response length in bytes. It is placed in the cdb's "allocation length" field. If not given  (or  LEN	is
	      zero) then 65536 is used. The maximum value of LEN is 65536.

       -q, --quiet
	      output ASCII hex rendering of each report lun, one per line.

       -r, --raw
	      output response in binary (to stdout).

       -s, --select=SR
	      this  option  sets  the 'select report' field (SR) in the SCSI REPORT LUNS command. The default value is 0. When 0 is given (or this
	      option is not specified) then the DEVICE should yield a list of luns addressable via this "I_T nexus" that  use  the  following  lun
	      addressing  methods:  logical  unit  addressing, peripheral device addressing and flat space addressing.	When 1 is given the DEVICE
	      should yield a list of only "well known" logical units addressable via this "I_T" nexus. When 2 is given the DEVICE should yield all
	      luns  addressable  via  this  "I_T" nexus.  To simplify, for the I_T nexus associated with the DEVICE, the meanings of the SR values
	      are:
		0 : all luns excluding well known logical units
		1 : well known logical units
		2 : all luns
	      Values greater than 2 are reserved (at SPC-4 (rev 8)).

       -v, --verbose
	      increase the level of verbosity, (i.e. debug output).

       -V, --version
	      print the version string and then exit.

EXIT STATUS

       The exit status of sg_luns is 0 when it is successful. Otherwise see the sg3_utils(8) man page.

AUTHORS

       Written by Douglas Gilbert.

REPORTING BUGS

       Report bugs to <dgilbert at interlog dot com>.

COPYRIGHT

       Copyright (C) 2004-2008 Douglas Gilbert
       This software is distributed under a FreeBSD license. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A  PARTICULAR  PUR-
       POSE.

SEE ALSO

       sg_inq(8)

sg3_utils-1.26							    April 2008								SG_LUNS(8)

SG_READ_BUFFER(8)						     SG3_UTILS							 SG_READ_BUFFER(8)

NAME

       sg_read_buffer - send 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. Alternatively 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.

       -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 (C) 2006-2012 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  PUR-
       POSE.

SEE ALSO

       sg_write_buffer(sg3_utils)

sg3_utils-1.35							   November 2012						 SG_READ_BUFFER(8)