diff options
author | Bart Van Assche <bvanassche@google.com> | 2022-11-23 18:56:18 +0000 |
---|---|---|
committer | Automerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com> | 2022-11-23 18:56:18 +0000 |
commit | 71b9916bab71328ec690b8677524e512d580d28f (patch) | |
tree | 207cdb23f8257e270a30143fde23d2033901581f /doc/sg_emc_trespass.8 | |
parent | 8718296061e35ba33bf88847e7498f3d7e38f8f1 (diff) | |
parent | 448b67b18a80f8cc0feaaa669deaf169faa169f3 (diff) | |
download | sg3_utils-71b9916bab71328ec690b8677524e512d580d28f.tar.gz |
Merge remote-tracking branch 'aosp/upstream-main' into HEAD am: 448b67b18a
Original change: https://android-review.googlesource.com/c/platform/external/sg3_utils/+/2312210
Change-Id: I9653250a81928fffacf92bb5d9daffbc0ad7b2a8
Signed-off-by: Automerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>
Diffstat (limited to 'doc/sg_emc_trespass.8')
-rw-r--r-- | doc/sg_emc_trespass.8 | 52 |
1 files changed, 52 insertions, 0 deletions
diff --git a/doc/sg_emc_trespass.8 b/doc/sg_emc_trespass.8 new file mode 100644 index 00000000..94b592bd --- /dev/null +++ b/doc/sg_emc_trespass.8 @@ -0,0 +1,52 @@ +.TH SG_EMC_TRESPASS "8" "December 2012" "sg3_utils\-1.35" SG3_UTILS +.SH NAME +sg_emc_trespass \- change ownership of SCSI LUN from another +Service\-Processor to this one +.SH SYNOPSIS +.B sg_emc_trespass +[\fI\-d\fR] [\fI\-hr\fR] [\fI\-s\fR] +[\fI\-V\fR] \fIDEVICE\fR +.SH DESCRIPTION +.\" Add any additional description here +.PP +sg_emc_trespass sends an EMC\-specific Trespass Command to the \fIDEVICE\fR +with the selected options. This Mode Select changes the ownership of the LUN +of the device from another Service\-Processor to the one the command was +received on. +.SH OPTIONS +Arguments to long options are mandatory for short options as well. +.TP +\fB\-d\fR +outputs some extra debug information associated with executing this command +.TP +\fB\-hr\fR +Sets the 'Honor Reservation' bit in the command. If set, the trespass +will only succeed to change the ownership from the Peer SP if the Peer +SP does not have an outstanding SCSI reservation for the LUN. By +default, the reservation state will be ignored. +.TP +\fB\-s\fR +Send the short version of the trespass command instead of the long +version. The short version is supported on the EMC FC5300, FC4500 and +FC4700. The long version (default) is supported on the CLARiiON CX and +AX family arrays. +.TP +\fB\-V\fR +print out version string then exit. +.PP +In the 2.4 series of Linux kernels the \fIDEVICE\fR must be a SCSI +generic (sg) device. In the 2.6 series block devices (e.g. SCSI disks +and DVD drives) can also be specified. For example "sg_start 0 /dev/sda" +will work in the 2.6 series kernels. +.SH EXIT STATUS +The exit status of sg_emc_trespass is 0 when it is successful. Otherwise see +the sg3_utils(8) man page. +.SH AUTHOR +Written by Lars Marowsky\-Bree, based on sg_start. +.SH "REPORTING BUGS" +Report bugs to <dgilbert at interlog dot com>. +.SH COPYRIGHT +Copyright \(co 2004\-2012 Lars Marowsky\-Bree, Douglas Gilbert. +.br +This software is distributed under the GPL version 2. There is NO +warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. |