mirror of
https://github.com/moibenko/mtx.git
synced 2025-12-23 05:55:13 +00:00
117 lines
3.8 KiB
Groff
117 lines
3.8 KiB
Groff
.\" scsieject.1 Document Copyright 2007-2008 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)
|