sg_rmsn(8) [debian man page]

SG_RMSN(8)							     SG3_UTILS								SG_RMSN(8)

NAME

       sg_rmsn - sends a SCSI READ MEDIA SERIAL NUMBER command

SYNOPSIS

       sg_rmsn [--help] [--raw] [--readonly] [--verbose] [--version] DEVICE

DESCRIPTION

       Send a SCSI READ MEDIA SERIAL NUMBER command to DEVICE and outputs the response.

       This  command is described in SPC-3 found at www.t10.org . It was originally added to SPC-3 in revision 11 (2003/2/12). It is not an manda-
       tory command and the author has not seen any SCSI devices that support it.

OPTIONS

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

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

       -r, --raw
	      sends the serial number (if found) to stdout. This output may contain non-printable characters (e.g. the	serial	number	is  padded
	      with  NULLs  at  the  end  so its length is a multiple of 4). The default action is to print the serial number out in ASCII-HEX with
	      ASCII characters to the right. All error messages are sent to stderr.

       -R, --readonly
	      opens the DEVICE read-only rather than read-write which is the default. The Linux sg driver needs read-write  access  for  the  SCSI
	      READ MEDIA SERIAL NUMBER command but other access methods may require read-only access.

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

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

NOTES

       Device  identification  information is also found in a standard INQUIRY response and its VPD pages (see sg_vpd). The relevant VPD pages are
       the "device identification page" (VPD page 0x83) and the "unit serial number" page (VPD page 0x80).

       The MMC-4 command set for CD/DVD/HD-DVD/BD drives has a "media serial number" feature (0x109) [and a "logical unit serial number" feature].
       These can be viewed with sg_get_config.

EXIT STATUS

       The exit status of sg_rmsn 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) 2005-2011 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_vpd(sg3_utils), sg_get_config(sg3_utils)

sg3_utils-1.31							   February 2011							SG_RMSN(8)

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 8192 is used. The maximum allowed 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 between 0xf8 and 0xff (inclusive) are vendor specific (SPC-4 (rev 32), other values greater than 2 are reserved.

       -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-2011 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.33							    August 2011 							SG_LUNS(8)