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] [--readonly] [--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       -R, --readonly
49              open the DEVICE read-only (e.g. in Unix with the O_RDONLY flag).
50              The default is to open it read-write.
51
52       -v, --verbose
53              increase the level of verbosity, (i.e. debug output). Additional
54              output caused by this option is sent to stderr.
55
56       -V, --version
57              print the version string and then exit.
58

NOTES

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

EXIT STATUS

64       The  exit  status of sg_referrals is 0 when it is successful. Otherwise
65       see the sg3_utils(8) man page.
66

AUTHORS

68       Written by Douglas Gilbert and Hannes Reinecke.
69

REPORTING BUGS

71       Report bugs to <dgilbert at interlog dot com>.
72

74       Copyright © 2009-2014 Douglas Gilbert and Hannes Reinecke
75       This software is distributed under a FreeBSD license. There is NO  war‐
76       ranty;  not  even  for MERCHANTABILITY or FITNESS FOR A PARTICULAR PUR‐
77       POSE.
78

SEE ALSO

80       sg_vpd(8)
81
82
83
84sg3_utils-1.39                     May 2014                    SG_REFERRALS(8)
Impressum