sg_referrals(8)

1SG_REFERRALS(8)                    SG3_UTILS                   SG_REFERRALS(8)
2
3
4

NAME

6       sg_referrals - send SCSI REPORT REFERRALS command
7

SYNOPSIS

9       sg_referrals  [--help]  [--hex]  [--lba=LBA] [--maxlen=LEN] [--one-seg‐
10       ment] [--raw] [--verbose] [--version] DEVICE
11

DESCRIPTION

13       Send the SCSI REPORT REFERRALS command to the DEVICE  and  outputs  the
14       response.  This command was introduced in (draft) SBC-3 revision 24 and
15       devices that support referrals should support this command.
16
17       The default action is to decode the response for all user data  segment
18       referral  descriptors. The amount of output can be reduced by the --lba
19       and --one-segment options.
20

OPTIONS

22       Arguments to long options are mandatory for short options as well.
23
24       -h, --help
25              output the usage message then exit.
26
27       -H, --hex
28              output response to this command in ASCII hex.
29
30       -l, --lba=LBA
31              where LBA is the Logical Block Address (LBA) in the  first  user
32              data  segment  the  DEVICE should report the referrals parameter
33              data for.
34
35       -m, --maxlen=LEN
36              where LEN is the (maximum)  response  length  in  bytes.  It  is
37              placed in the cdb's "allocation length" field. If not given then
38              256 is used. 256 is enough space for  the  response  header  and
39              user data segment descriptors.
40
41       -s, --one-segment
42              report the user data segment of the segment spefified by the LBA
43              parameter only.
44
45       -r, --raw
46              output response in binary (to stdout).
47
48       -v, --verbose
49              increase the level of verbosity, (i.e. debug output). Additional
50              output caused by this option is sent to stderr.
51
52       -V, --version
53              print the version string and then exit.
54

NOTES

56       For  a  discussion  of  referrals  see  section  4.25 of sbc3r25.pdf at
57       http://www.t10.org (or the corresponding section of a later draft).
58

EXIT STATUS

60       The exit status of sg_referrals is 0 when it is  successful.  Otherwise
61       see the sg3_utils(8) man page.
62

AUTHORS

64       Written by Douglas Gilbert and Hannes Reinecke.
65

REPORTING BUGS

67       Report bugs to <dgilbert at interlog dot com>.
68

COPYRIGHT

70       Copyright © 2009-2012 Douglas Gilbert and Hannes Reinecke
71       This  software is distributed under a FreeBSD license. There is NO war‐
72       ranty; not even for MERCHANTABILITY or FITNESS FOR  A  PARTICULAR  PUR‐
73       POSE.
74