SG3UTILS                                             SGLUNS(1M)



NAME
     sgluns - send the SCSI REPORT LUNS command

SYNOPSIS
     sgluns [--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 ASCI 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 max-
          imum value of LEN is 65536.

     -q, --quiet
          output ASCI 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
          "IT 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 "IT" nexus. When  2
          is  given  the DEVICE should yield all luns addressable
          via this "IT" nexus.  To simplify, for the  IT  nexus



sg3utils-1.26       Last change: April 2008                    1






SG3UTILS                                             SGLUNS(1M)



          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 sgluns is 0 when it is successful.  Oth-
     erwise see the sg3utils(1M) man page.

AUTHORS
     Written by Douglas Gilbert.

REPORTING BUGS
     Report bugs to .

COPYRIGHT
     Copyright O 2004-2008 Douglas Gilbert
     This software is distributed under a FreeBSD license.  There
     is  NO warranty; not even for MERCHANTABILITY or FITNES FOR
     A PARTICULAR PURPOSE.

SEE ALSO
     sginq(1M)

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     
       ATRIBUTE TYPE     ATRIBUTE VALUE
    
     Availability         SUNWsg3utilsu  
    
     Interface Stability  Committed      
    

NOTES
     Source for sg3utils is available on http:/opensolaris.org.









sg3utils-1.26       Last change: April 2008                    2