scsieject(1)

1scsieject(1)                General Commands Manual               scsieject(1)
2
3
4

NAME

6       scsieject - control SCSI tape devices
7

SYNOPSIS

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

DESCRIPTION

12       The  scsieject  command controls SCSI devices in a platform-independent
13       manner. As long as 'mtx' works on the platform, so does 'scsieject'.
14

OPTIONS

16       The first argument, given following -f , is  the  SCSI  generic  device
17       corresponding to your tape drive.  Consult your operating system's doc‐
18       umentation for more information (for example,  under  Linux  these  are
19       generally   /dev/sg0   through   /dev/sg15,  under  FreeBSD  these  are
20       /dev/pass0 through /dev/passX. Under Solaris this is usually  the  same
21       as  your tape drive (Solaris has a SCSI passthrough ioctl). You can set
22       the STAPE or TAPE environment variable rather than use -f.
23

COMMANDS

25       load      Load the medium into the drive.  When this command is  issued
26                 to  a  CD/DVD drive and the tray is extended the tray will be
27                 retracted if the drive is capable of it.
28
29
30       unload    Unload the medium from the drive (also known as eject).  When
31                 this  command is issued to a CD/DVD drive or a tape drive the
32                 media will be ejected if the device supports it.
33
34
35       start     Start the device.  Some devices require a start command after
36                 a media changer has loaded new media into the device.
37
38
39       stop      Stop  the  device.  Some devices require a stop command prior
40                 to unloading the medium from the device when  using  a  media
41                 changer.
42
43
44       lock      Lock  the device.  Locks the device so that the medium cannot
45                 be removed manually.
46
47
48       unlock    Unlock the device.  Unlocks the device so that the medium can
49                 be removed manually.
50
51

AUTHORS

53       This  program  was written by Robert Nelson <robertnelson@users.source‐
54       forge.net> based on the scsitape program  written  by  Eric  Lee  Green
55       <eric@badtux.org>.   Major portions of the 'mtxl.c' library used herein
56       were written by Leonard Zubkoff.
57

HINTS

59       Under Linux, cat /proc/scsi/scsi will tell you what  SCSI  devices  you
60       have.   You  can  then refer to them as /dev/sga, /dev/sgb, etc. by the
61       order they are reported.
62
63       Under FreeBSD, camcontrol devlist will tell you what SCSI  devices  you
64       have, along with which pass device controls them.
65
66       Under  Solaris  7  and  8,  /usr/sbin/devfsadm  -C  will  clean up your
67       /devices directory. Then find /devices -name 'st@*' -print will  return
68       a  list  of all tape drives. /dev on Solaris is apparently only of his‐
69       torical interest.
70
71

BUGS AND LIMITATIONS

73       There are no known bugs or limitations.
74
75

AVAILABILITY

77       This version of scsieject is currently being maintained by Robert  Nel‐
78       son  <robertnelson@users.sourceforge.net> as part of the 'mtx' suite of
79       programs. The 'mtx' home page  is  http://mtx.sourceforge.net  and  the
80       actual   code   is   currently   available   there  and  via  SVN  from
81       http://sourceforge.net/projects/mtx.
82
83