diff options
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. |