scsieject

Section: User Commands (1)
Updated: scsieject1.0
Index

NAME

scsieject - control SCSI tape devices

SYNOPSIS

scsieject [-f <scsi-generic-device>] commands

DESCRIPTION

The scsiejectcommand controls SCSI devices in a platform-independentmanner. As long as 'mtx' works on the platform, so does 'scsieject'.

OPTIONS

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.

COMMANDS

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.
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.
start: Start the device. Some devices require a start command after a media changer has loaded new media into the device.
stop: Stop the device. Some devices require a stop command prior to unloading the medium from the device when using a media changer.
lock: Lock the device. Locks the device so that the medium cannot be removed manually.
unlock: Unlock the device. Unlocks the device so that the medium can be removed manually.

AUTHORS

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.

HINTS

Under Linux, cat /proc/scsi/scsiwill 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 devlistwill tell you what SCSI devices youhave, along with which passdevice controls them.Under Solaris 7 and 8,/usr/sbin/devfsadm -Cwill 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.

AVAILABILITY

This version of scsiejectis 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.

This document was created byman2html,using the manual pages.