| .TH SG_EMC_TRESPASS "8" "Oct 2004" "sg3_utils-1.09" SG3_UTILS |
| .SH NAME |
| sg_emc_trespass \- Changes ownership of a 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] \fI<sg_device>\fR |
| .SH DESCRIPTION |
| .\" Add any additional description here |
| .PP |
| sg_emc_trespass sends an EMC-specific Trespass Command to the given |
| device 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. |
| .TP |
| -d |
| outputs some extra debug information associated with executing this command |
| .TP |
| -hr |
| 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 |
| -s |
| 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 |
| -V |
| print out version string then exit. |
| .PP |
| In the 2.4 series of Linux kernels the given device must be |
| a SCSI generic (sg) device. In the 2.6 series block devices (e.g. disks |
| and SCSI DVDs) can also be specified. For example "sg_start 0 /dev/sda" |
| will work in the 2.6 series kernels. |
| .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 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. |
