Go to main content

man pages section 8: System Administration Commands

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

sg_referrals (8)

Name

sg_referrals - send SCSI REPORT REFERRALS command

Synopsis

sg_referrals  [--help]  [--hex]  [--lba=LBA] [--maxlen=LEN] [--one-seg-
ment] [--raw] [--readonly] [--verbose] [--version] DEVICE

Description

SG_REFERRALS(8)                    SG3_UTILS                   SG_REFERRALS(8)



NAME
       sg_referrals - send SCSI REPORT REFERRALS command

SYNOPSIS
       sg_referrals  [--help]  [--hex]  [--lba=LBA] [--maxlen=LEN] [--one-seg-
       ment] [--raw] [--readonly] [--verbose] [--version] DEVICE

DESCRIPTION
       Send the SCSI REPORT REFERRALS command to the DEVICE  and  outputs  the
       response.  This command was introduced in (draft) SBC-3 revision 24 and
       devices that support referrals should support this command.

       The default action is to decode the response for all user data  segment
       referral  descriptors. The amount of output can be reduced by the --lba
       and --one-segment options.

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

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

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

       -l, --lba=LBA
              where LBA is the Logical Block Address (LBA) in the  first  user
              data  segment  the  DEVICE should report the referrals parameter
              data for.

       -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 then
              256 is used. 256 is enough space for  the  response  header  and
              user data segment descriptors.

       -s, --one-segment
              report the user data segment of the segment spefified by the LBA
              parameter only.

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

       -R, --readonly
              open the DEVICE read-only (e.g. in Unix with the O_RDONLY flag).
              The default is to open it read-write.

       -v, --verbose
              increase the level of verbosity, (i.e. debug output). Additional
              output caused by this option is sent to stderr.

       -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
       For a discussion of  referrals  see  section  4.25  of  sbc3r25.pdf  at
       http://www.t10.org (or the corresponding section of a later draft).

       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_referrals is 0 when it is  successful.  Otherwise
       see the sg3_utils(8) man page.

AUTHORS
       Written by Douglas Gilbert and Hannes Reinecke.

REPORTING BUGS
       Report bugs to <dgilbert at interlog dot com>.

COPYRIGHT
       Copyright (C) 2009-2014 Douglas Gilbert and Hannes Reinecke
       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(8)




sg3_utils-1.39                     May 2014                    SG_REFERRALS(8)