sg_rmsn - send SCSI READ MEDIA SERIAL NUMBER command
sg_rmsn [--help] [--raw] [--readonly] [--verbose] [--version] DEVICE
SG_RMSN(8) SG3_UTILS SG_RMSN(8)
NAME
sg_rmsn - send 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 origi-
nally added to SPC-3 in revision 11 (2003/2/12). It is not an mandatory
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.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+--------------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+--------------------------+
|Availability | system/storage/sg3_utils |
+---------------+--------------------------+
|Stability | Pass-through uncommitted |
+---------------+--------------------------+
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 num-
ber" 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.
Source code for open source software components in Oracle Solaris can
be found at https://www.oracle.com/downloads/opensource/solaris-source-
code-downloads.html.
This software was built from source available at
https://github.com/oracle/solaris-userland. The original community
source was downloaded from http://sg.danny.cz/sg/p/sg3_utils-1.46.tgz.
Further information about this software can be found on the open source
community website at http://sg.danny.cz/sg/sg3_utils.html.
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-2012 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_vpd(sg3_utils), sg_get_config(sg3_utils)
sg3_utils-1.31 November 2012 SG_RMSN(8)