oracular (1) scsieject.1.gz

Provided by: mtx_1.3.12-16build1_amd64 bug

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/sgXX, 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, lsscsi --generic will tell you what SCSI devices you have and their device names.

       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)