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