sg_prevent - send SCSI PREVENT ALLOW MEDIUM REMOVAL command
sg_prevent [--allow] [--help] [--prevent=PC] [--verbose] [--version] DEVICE
SG_PREVENT(8) SG3_UTILS SG_PREVENT(8)
NAME
sg_prevent - send SCSI PREVENT ALLOW MEDIUM REMOVAL command
SYNOPSIS
sg_prevent [--allow] [--help] [--prevent=PC] [--verbose] [--version]
DEVICE
DESCRIPTION
Sends a SCSI PREVENT ALLOW MEDIUM REMOVAL command to DEVICE. The
default action of this utility is to prevent the removing or ejecting
of the medium from a drive. This is done by ignoring the SCSI START
STOP UNIT command (see sg_start) and ignoring the eject button on the
drive when the user presses it. Drives that hold removable disks, tape
cartridges or cd/dvd media typically implement this command. The defi-
nition of the "prevent" codes for this command differ between disks and
tapes (covered by SBC-3 and SSC-3) and cd/dvd drives (covered by
MMC-5). The "prevent codes" described here are from MMC-5.
OPTIONS
Arguments to long options are mandatory for short options as well.
-a, --allow
allow medium removal. This is equivalent to setting to '--pre-
vent=2'. Cannot be used with --prevent=PC option (i.e. either
use no options (hence prevent removal), this option or --pre-
vent=PC).
-h, --help
output the usage message then exit.
-p, --prevent=PC
where PC is a prevent code value. Defined values are: 0 allows
removal, 1 prevents removal (default), 2 allows persistent
removal while 3 prevents persistent removal. "Persistent" in
this context means that the initiator (port) that successfully
uses code 3 blocks other initiators (ports) from allowing
removal. A "persistent prevent" state can be cleared by the
owner allowing persistent removal (code 2) or a power cycle (or
anything that resets the device (LU)) or some special commands
(e.g. various service actions of Persistent Reserve Out, see
SPC-3).
-v, --verbose
increase the level of verbosity, (i.e. debug output).
-V, --version
print the version string and then exit.
EXIT STATUS
The exit status of sg_prevent is 0 when it is successful. Otherwise see
the sg3_utils(8) man page.
AUTHORS
Written by Douglas Gilbert.
REPORTING BUGS
Report bugs to <dgilbert at interlog dot com>.
COPYRIGHT
Copyright (C) 2004-2012 Douglas Gilbert
This software is distributed under a FreeBSD license. There is NO war-
ranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PUR-
POSE.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+--------------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+--------------------------+
|Availability | system/storage/sg3_utils |
+---------------+--------------------------+
|Stability | Pass-through uncommitted |
+---------------+--------------------------+
SEE ALSO
sg_start(sg3_utils), sg_persist(sg3_utils)
NOTES
Source code for open source software components in Oracle Solaris can
be found at https://www.oracle.com/downloads/opensource/solaris-source-
code-downloads.html.
This software was built from source available at
https://github.com/oracle/solaris-userland. The original community
source was downloaded from http://sg.danny.cz/sg/p/sg3_utils-1.46.tgz.
Further information about this software can be found on the open source
community website at http://sg.danny.cz/sg/sg3_utils.html.
sg3_utils-1.35 November 2012 SG_PREVENT(8)