jammy (1) scsieject.1.gz

Provided by: mtx_1.3.12-14build2_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/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)