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-segment] [--raw] [--read-
only] [--verbose] [--version] DEVICE
DESCRIPTION
Send the SCSI REPORT REFERRALS command to the DEVICE and outputs the response. This com-
mand 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 descrip-
tors. 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 DE-
VICE 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 "al-
location 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.
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)
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 warranty; not even for
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
SEE ALSO
sg_vpd(8)
sg3_utils-1.39 May 2014 SG_REFERRALS(8)
Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache
Under GNU General Public License
2025-11-21 16:32 @216.73.216.57 CrawledBy Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)