man pages section 1M: System Administration Commands

Exit Print View

Updated: July 2014
 
 

sg_rmsn (1m)

Name

sg_rmsn - sends a SCSI READ MEDIA SERIAL NUMBER command

Synopsis

sg_rmsn  [--help]  [--raw]  [--readonly] [--verbose] [--ver-
sion] DEVICE

Description




SG3_UTILS                                              SG_RMSN(8)



NAME
     sg_rmsn - sends a SCSI READ MEDIA SERIAL NUMBER command

SYNOPSIS
     sg_rmsn  [--help]  [--raw]  [--readonly] [--verbose] [--ver-
     sion] 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 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 out-
          put 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(5)   for   descriptions  of  the  following
     attributes:







sg3_utils-1.31      Last change: February 2011                  1






SG3_UTILS                                              SG_RMSN(8)



     +---------------+--------------------------+
     |ATTRIBUTE TYPE |     ATTRIBUTE VALUE      |
     +---------------+--------------------------+
     |Availability   | system/storage/sg3_utils |
     +---------------+--------------------------+
     |Stability      | Uncommitted              |
     +---------------+--------------------------+
NOTES
     Device identification information is also found in  a  stan-
     dard  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. Oth-
     erwise 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 PURPOSE.

SEE ALSO
     sg_vpd(sg3_utils), sg_get_config(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

     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                  2