Section: User Commands (1)
scsieject - control SCSI tape devices
scsieject [-f <scsi-generic-device>] commands
command controls SCSI devices in a platform-independentmanner. As long as 'mtx' works on the platform, so does 'scsieject'.
The first argument, given following-f
, is the SCSI generic device corresponding to your tape drive.Consult your operating system's documentation for more information (forexample, under Linux these are generally /dev/sg0 through /dev/sg15, under FreeBSD these are /dev/pass0 through /dev/passX. Under Solaristhis is usually the same as your tape drive (Solaris has a SCSI passthroughioctl). You can set the STAPE or TAPE environment variable ratherthan use -f.
- 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.
- 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.
- Start the device. Some devices require a start command after a media changer has loaded new media into the device.
- Stop the device. Some devices require a stop command prior to unloading the medium from the device when using a media changer.
- Lock the device. Locks the device so that the medium cannot be removed manually.
- Unlock the device. Unlocks the device so that the medium can be removed manually.
This program was written by Robert Nelson <robertnelsonAATTusers.sourceforge.net> based on the scsitape program written by Eric Lee Green <ericAATTbadtux.org>. Major portions of the 'mtxl.c' library used herein were written byLeonard Zubkoff.
Under Linux, cat /proc/scsi/scsi
will tell you what SCSI devices you have.You can then refer to them as /dev/sga,/dev/sgb,
etc. by the order theyare reported.Under FreeBSD, camcontrol devlist
will tell you what SCSI devices youhave, along with which pass
device controls them.Under Solaris 7 and 8,/usr/sbin/devfsadm -C
will clean up your /devices directory. Thenfind /devices -name 'st@*' -print
will return a list of all tape drives. /dev on Solaris is apparently onlyof historical interest.
BUGS AND LIMITATIONS
There are no known bugs or limitations.
This version of scsieject
is currently being maintained by Robert Nelson <robertnelsonAATTusers.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.
- BUGS AND LIMITATIONS
- SEE ALSO
This document was created byman2html,using the manual pages.