diff options
author | Bart Van Assche <bvanassche@google.com> | 2022-11-23 20:04:46 +0000 |
---|---|---|
committer | Automerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com> | 2022-11-23 20:04:46 +0000 |
commit | 62b99c09a4bbb75fea6c309c77ebf856323d908c (patch) | |
tree | 207cdb23f8257e270a30143fde23d2033901581f /doc/sg_referrals.8 | |
parent | 8718296061e35ba33bf88847e7498f3d7e38f8f1 (diff) | |
parent | 3c61bd9e26bf930f865e28e7eef48856653d1c98 (diff) | |
download | sg3_utils-62b99c09a4bbb75fea6c309c77ebf856323d908c.tar.gz |
Merge remote-tracking branch 'aosp/upstream-main' into HEAD am: 448b67b18a am: d39ef90544 am: 3c61bd9e26
Original change: https://android-review.googlesource.com/c/platform/external/sg3_utils/+/2312210
Change-Id: I0362cffa263ba632a3e2058f8f50f32e024b2cc3
Signed-off-by: Automerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>
Diffstat (limited to 'doc/sg_referrals.8')
-rw-r--r-- | doc/sg_referrals.8 | 71 |
1 files changed, 71 insertions, 0 deletions
diff --git a/doc/sg_referrals.8 b/doc/sg_referrals.8 new file mode 100644 index 00000000..60111063 --- /dev/null +++ b/doc/sg_referrals.8 @@ -0,0 +1,71 @@ +.TH SG_REFERRALS "8" "May 2014" "sg3_utils\-1.39" SG3_UTILS +.SH NAME +sg_referrals \- send SCSI REPORT REFERRALS command +.SH SYNOPSIS +.B sg_referrals +[\fI\-\-help\fR] [\fI\-\-hex\fR] [\fI\-\-lba=LBA\fR] [\fI\-\-maxlen=LEN\fR] +[\fI\-\-one-segment\fR] [\fI\-\-raw\fR] [\fI\-\-readonly\fR] +[\fI\-\-verbose\fR] [\fI\-\-version\fR] \fIDEVICE\fR +.SH DESCRIPTION +.\" Add any additional description here +.PP +Send the SCSI REPORT REFERRALS command to the \fIDEVICE\fR and outputs the +response. This command was introduced in (draft) SBC\-3 revision 24 and +devices that support referrals should support this command. +.PP +The default action is to decode the response for all user data segment +referral descriptors. The amount of output can be reduced by the +\fI\-\-lba\fR and \fI\-\-one-segment\fR options. +.SH OPTIONS +Arguments to long options are mandatory for short options as well. +.TP +\fB\-h\fR, \fB\-\-help\fR +output the usage message then exit. +.TP +\fB\-H\fR, \fB\-\-hex\fR +output response to this command in ASCII hex. +.TP +\fB\-l\fR, \fB\-\-lba\fR=\fILBA\fR +where \fILBA\fR is the Logical Block Address (LBA) in the first user +data segment the \fIDEVICE\fR should report the referrals parameter +data for. +.TP +\fB\-m\fR, \fB\-\-maxlen\fR=\fILEN\fR +where \fILEN\fR 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. +.TP +\fB\-s\fR, \fB\-\-one-segment\fR +report the user data segment of the segment specified by the \fILBA\fR +parameter only. +.TP +\fB\-r\fR, \fB\-\-raw\fR +output response in binary (to stdout). +.TP +\fB\-R\fR, \fB\-\-readonly\fR +open the \fIDEVICE\fR read\-only (e.g. in Unix with the O_RDONLY flag). +The default is to open it read\-write. +.TP +\fB\-v\fR, \fB\-\-verbose\fR +increase the level of verbosity, (i.e. debug output). Additional output +caused by this option is sent to stderr. +.TP +\fB\-V\fR, \fB\-\-version\fR +print the version string and then exit. +.SH NOTES +For a discussion of referrals see section 4.25 of sbc3r25.pdf +at https://www.t10.org (or the corresponding section of a later draft). +.SH EXIT STATUS +The exit status of sg_referrals is 0 when it is successful. Otherwise +see the sg3_utils(8) man page. +.SH AUTHORS +Written by Douglas Gilbert and Hannes Reinecke. +.SH "REPORTING BUGS" +Report bugs to <dgilbert at interlog dot com>. +.SH COPYRIGHT +Copyright \(co 2009\-2014 Douglas Gilbert and Hannes Reinecke +.br +This software is distributed under a BSD\-2\-Clause license. There is NO +warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +.SH "SEE ALSO" +.B sg_vpd(8) |