3 .\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/>
8 .TH "AMTAPE" "8" "08/22/2008" "" ""
9 .\" disable hyphenation
11 .\" disable justification (adjust text to left margin only)
14 amtape - user interface to Amanda tape changer controls
17 \fBamtape\fR \fIconfig\fR \fIcommand\fR [\fIcommand_options\fR...] [\fB\-o\ \fR\fIconfigoption\fR]...
21 performs tape changer control operations\. It uses the underlying tape changer script defined by the
23 option for a particular
25 configuration as specified by the
29 Tape changers maintain a notion of the
33 slot for each configuration\. These may or may not correspond to an actual physical state of the device, but do tend to minimize searching through the tape storage slots\. If the desired tape is in the current slot, it is likely the next tape needed is in the next slot rather than at some random position in the storage slots\.
37 man page for more details about
43 Reset the tape changer to a known state\. The
47 slot\. Other device\-specific side effects may occur\. Some gravity stackers need to be reset to the top position by hand\. This command notifies
49 the stacker is back in that position\.
54 If a tape is loaded in the drive, it is ejected and returned to the slot from which it was loaded\.
59 If a cleaning tape is defined for the changer, it is used to clean the drive\.
64 Show the contents of all slots\. This can be slow\.
67 \fBlabel\fR \fIlabel\fR
69 Search for and load the
79 scan algorithm\. Load the next tape in the configuration\'s tape sequence, or a fresh tape with a suitable label\.
84 Display the name of the current tape device on
90 Display the current slot\.
95 Update the changer label database, if it has one, to match the tapes now available\.
100 Eject any tape in the drive and put it away, then load the tape from slot
108 Eject any tape in the drive and put it away, then load the tape from the current slot\.
113 Eject any tape in the drive and put it away, then load the tape from the previous slot and reset
119 Eject any tape in the drive and put it away, then load the tape from the next slot and reset
125 Eject any tape in the drive and put it away, then load the tape from the first slot and reset
131 Eject any tape in the drive and put it away, then load the tape from the last slot and reset
137 Eject any tape in the drive and put it away\. Advance
139 to the next tape, but do not load it\.
142 \fB\-o\fR \fIconfigoption\fR
144 See the "\fBCONFIGURATION OVERRIDE\fR" section in
148 This is useful with non\-gravity stackers to unload the last tape used and set up
150 for the next run\. If you just use
151 \fBeject\fR, the current tape will be mounted again in the next run, where it will be rejected as being still in use, ejected and the next tape requested\. Using
155 does an unnecessary mount\.
157 Note: most changers optimize the
159 commands to not eject the loaded tape if it is the one being requested\.
166 Stefan G\. Weichinger,
167 <sgw@amanda\.org>, maintainer of the
168 \fIAmanda\fR\-documentation: XML\-conversion
172 : http://wiki.zmanda.com