--- /dev/null
+.\" scsieject.1 Document Copyright 2007 Robert Nelson
+.\"
+.\" This is free documentation; you can redistribute it and/or
+.\" modify it under the terms of the GNU General Public License as
+.\" published by the Free Software Foundation; either version 2 of
+.\" the License, or (at your option) any later version.
+.\"
+.\" The GNU General Public License's references to "object code"
+.\" and "executables" are to be interpreted as the output of any
+.\" document formatting or typesetting system, including
+.\" intermediate and printed output.
+.\"
+.\" This manual is distributed in the hope that it will be useful,
+.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
+.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+.\" GNU General Public License for more details.
+.\"
+.\" You should have received a copy of the GNU General Public
+.\" License along with this manual; if not, write to the Free
+.\" Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139,
+.\" USA.
+.\"
+.TH scsieject 1 scsieject1.0
+.SH NAME
+scsieject \- control SCSI tape devices
+.SH SYNOPSIS
+scsieject [-f <scsi-generic-device>] commands
+.SH DESCRIPTION
+The
+.B scsieject
+command controls SCSI devices in a platform-independent
+manner. As long as 'mtx' works on the platform, so does 'scsieject'.
+.SH OPTIONS
+The first argument, given following
+.B -f
+, is the SCSI generic device corresponding to your tape drive.
+Consult your operating system's documentation for more information (for
+example, under Linux these are generally /dev/sg0 through /dev/sg15,
+under FreeBSD these are /dev/pass0 through /dev/passX. Under Solaris
+this is usually the same as your tape drive (Solaris has a SCSI passthrough
+ioctl). You can set the STAPE or TAPE environment variable rather
+than use -f.
+.P
+.SH COMMANDS
+.TP 10
+.B load
+Load the medium into the drive. When this command is issued to a CD/DVD drive
+and the tray is extended the tray will be retracted if the drive is capable of it.
+
+.TP 10
+.B unload
+Unload the medium from the drive (also known as eject). When this command is issued
+to a CD/DVD drive or a tape drive the media will be ejected if the device supports it.
+
+.TP 10
+.B start
+Start the device. Some devices require a start command after a media changer has
+loaded new media into the device.
+
+.TP 10
+.B stop
+Stop the device. Some devices require a stop command prior to unloading the medium
+from the device when using a media changer.
+
+.TP 10
+.B lock
+Lock the device. Locks the device so that the medium cannot be removed manually.
+
+.TP 10
+.B unlock
+Unlock the device. Unlocks the device so that the medium can be removed manually.
+
+.SH AUTHORS
+This program was written by Robert Nelson <robertnelson@users.sourceforge.net>
+based on the scsitape program written by Eric Lee Green <eric@badtux.org>.
+Major portions of the 'mtxl.c' library used herein were written by
+Leonard Zubkoff.
+.P
+
+.SH HINTS
+Under Linux,
+.B cat /proc/scsi/scsi
+will tell you what SCSI devices you have.
+You can then refer to them as
+.B /dev/sga,
+.B /dev/sgb,
+etc. by the order they
+are reported.
+.P
+Under FreeBSD,
+.B camcontrol devlist
+will tell you what SCSI devices you
+have, along with which
+.B pass
+device controls them.
+.P
+Under Solaris 7 and 8,
+.B /usr/sbin/devfsadm -C
+will clean up your /devices directory. Then
+.B find /devices -name 'st@*' -print
+will return a list of all tape drives. /dev on Solaris is apparently only
+of historical interest.
+
+.SH BUGS AND LIMITATIONS
+There are no known bugs or limitations.
+
+.SH AVAILABILITY
+This version of
+.B scsieject
+is currently being maintained by Robert Nelson <robertnelson@users.sourceforge.net>
+as part of the 'mtx' suite of programs. The 'mtx' home page is
+http://mtx.sourceforge.net and the actual code is currently available there and via
+SVN from http://sourceforge.net/projects/mtx.
+
+.SH SEE ALSO
+.BR loaderinfo (1), tapeinfo (1), mtx (1)
projects / debian / mtx / blobdiff