NAME

       scsieject - control SCSI tape devices

SYNOPSIS

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

DESCRIPTION

       The  scsieject  command controls SCSI devices in a platform-independent manner. 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 (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.

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 <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.

HINTS

       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 they are reported.

       Under FreeBSD, camcontrol devlist will tell you what SCSI devices  you  have,  along  with
       which pass device controls them.

       Under  Solaris  7 and 8, /usr/sbin/devfsadm -C will clean up your /devices directory. Then
       find /devices -name 'st@*' -print will return a list of all tape drives. /dev  on  Solaris
       is apparently only of historical interest.

BUGS AND LIMITATIONS

       There are no known bugs or limitations.

AVAILABILITY

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

SEE ALSO

       loaderinfo(1),tapeinfo(1),mtx(1)

                                           scsieject1.0                              scsieject(1)