.\" mtx.1 Document copyright 2000 Eric Lee Green
.\" Program Copyright 1996, 1997 Leonard Zubkoff
-.\" Extensive changes 2000 by Eric Lee Green <eric@estinc.com>
+.\" Copyright 2007-2008 by Robert Nelson <robertn@the-nelsons.org>
+.\" Extensive changes 2000 by Eric Lee Green <eric@badtux.org>
.\"
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139,
.\" USA.
.\"
-.TH MTX 1 MTX1.2
+.TH MTX 1 MTX1.3
.SH NAME
mtx \- control SCSI media changer devices
.SH SYNOPSIS
are 0 (do nothing to the import/export tray), 1, and 2 (what 1 and 2 do varies
depending upon the library, consult your library's SCSI-level
documentation).
+.TP 10
+.B [eepos <operation>] [invert] [invert2] exchange <slotnum> <slotnum> [<slotnum>]
+Move medium from the first slot to the second slot, placing the medium
+currently in the second slot either back into the first slot or into the
+optional third slot.
+
.TP 10
.B first [<drivenum>]
-Loads drive <drivenum> from the first slot in the media changer. Unloads
-the drive if there is already media in it. Note that
-this command may not be what you want on large tape libraries -- e.g. on Exabyte 220, the first slot is
-usually a cleaning tape. If <drivenum> is omitted, defaults to first drive.
+Loads drive <drivenum> from the first slot in the media
+changer. Unloads the drive if there is already media in it (note: you
+may need to eject the tape using your OS's tape control commands
+first). Note that this command may not be what you want on large
+tape libraries -- e.g. on Exabyte 220, the first slot is usually a
+cleaning tape. If <drivenum> is omitted, defaults to first drive.
.TP 10
.B last [<drivenum>]
Loads drive <drivenum> from the last slot in the media changer. Unloads
-the drive if there is already a tape in it.
+the drive if there is already a tape in it. (Note: you may need to eject
+the tape using your OS's tape control commands first).
.TP 10
.B next [<drivenum>]
Unloads the drive and loads the next tape in sequence. If the drive was
empty, loads the first tape into the drive.
+.TP 10
+.B position <slotnum>
+Positions the robot at a specific slot. Needed by some changers to
+move to and open the import/export, or mailbox, slot.
.SH AUTHORS
The original 'mtx' program was written by Leonard Zubkoff and extensively
revised for large multi-drive libraries with bar code readers
-by Eric Lee Green <eric@badtux.org>, to whom all problems should
-be reported for this revision. See 'mtx.c' for other contributors.
+by Eric Lee Green <eric@badtux.org>. See 'mtx.c' for other contributors.
.SH BUGS AND LIMITATIONS
.P
You may need to do a 'mt offline' on the tape drive to eject the tape
DDS-4 autochanger with 6 slots). It may not work on other operating systems
with larger libraries,
due to the big SCSI request size.
-Report problems to Eric Lee Green <eric@badtux.org>.
+Please see the projecdt page http://sourceforge.net/projects/mtx for information
+on reporting bugs, requesting features and the mailing list for peer support.
.SH HINTS
Under Linux,
.B cat /proc/scsi/scsi
then reboot. You can find your changer in /devices by typing
.B /usr/sbin/devfsadm -C
to clean out no-longer-extant entries in your /devices directory, then
-.B find /devices -name \*changer -print
+.B find /devices -name \e\(**changer -print
to find the device name. Set the symbolic link
.B /dev/changer
to point
to that device name (if it is not doing so already).
.P
-With BRU, set your mount and unmount commands as described on the EST
-web site at http://www.estinc.com to move to the next tape when backing up
+With BRU, set your mount and unmount commands as described on the BRU
+web site at http://www.bru.com to move to the next tape when backing up
or restoring. With GNU
.B tar,
see
.SH AVAILABILITY
This version of
.B mtx
-is currently being maintained by Eric Lee Green <eric@badtux.org> formerly of
-Enhanced Software Technologies Inc. The 'mtx' home page is
-http://mtx.sourceforge.net and the actual code
-is currently available there and via CVS from
-http://sourceforge.net/projects/mtx/ .
-
+is currently being maintained by Robert Nelson <robertnelson@users.sourceforge.net> .
+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.
.SH SEE ALSO
-.BR mt (1), tapeinfo (1), scsitape(1), loaderinfo(1)
+.BR mt (1), loaderinfo (1), tapeinfo (1), scsitape (1), scsieject (1)