# sg_referrals(8) - man - phpman

[SG_REFERRALS(8)](https://www.chedong.com/phpMan.php/man/SGREFERRALS/8/markdown)                               SG3_UTILS                              [SG_REFERRALS(8)](https://www.chedong.com/phpMan.php/man/SGREFERRALS/8/markdown)



## NAME
       sg_referrals - send SCSI REPORT REFERRALS command

## SYNOPSIS
       **sg**___**referrals** [_--help_] [_--hex_] [_--lba=LBA_] [_--maxlen=LEN_] [_--one-segment_] [_--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
              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
              where _LEN_ is the (maximum) response length in bytes. It is placed in the cdb's  "allo‐
              cation  length"  field. If not given then 256 is used. 256 is enough space for the re‐
              sponse 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.

## 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).

## EXIT STATUS
       The  exit  status  of sg_referrals is 0 when it is successful. Otherwise see the [sg3_utils(8)](https://www.chedong.com/phpMan.php/man/sg3utils/8/markdown)
       man page.

## AUTHORS
       Written by Douglas Gilbert and Hannes Reinecke.

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

## COPYRIGHT
       Copyright © 2009-2014 Douglas Gilbert and Hannes Reinecke
       This software is distributed under a FreeBSD license. There is NO warranty; not even for MER‐
       CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

## SEE ALSO
       **sg**___**[vpd(8)](https://www.chedong.com/phpMan.php/man/vpd/8/markdown)**



sg3_utils-1.39                                May 2014                               [SG_REFERRALS(8)](https://www.chedong.com/phpMan.php/man/SGREFERRALS/8/markdown)