Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   26626 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

SG_PREVENT(8)			   SG3_UTILS			 SG_PREVENT(8)

NAME
       sg_prevent - sends a 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 (lun)) 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 © 2004-2007 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.

SEE ALSO
       sg_start(sg3_utils), sg_persist(sg3_utils)

sg3_utils-1.23			 January 2007			 SG_PREVENT(8)

Vote for polarhome