1 <?xml version="1.0" encoding="ISO-8859-1"?>
2 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
3 "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"
5 <!-- entities files to use -->
6 <!ENTITY % global_entities SYSTEM '../entities/global.entities'>
10 <!-- lifted from troff+man by doclifter -->
11 <refentry id='amtape.8'>
14 <refentrytitle>amtape</refentrytitle>
15 <manvolnum>8</manvolnum>
18 <refname>amtape</refname>
19 <refpurpose>user interface to &A; tape changer controls</refpurpose>
21 <!-- body begins here -->
24 <command>amtape</command>
25 <arg choice='plain'><replaceable>config</replaceable></arg>
26 <arg choice='plain'><replaceable>command</replaceable></arg>
27 <arg choice='opt' rep='repeat'><replaceable>command_options</replaceable></arg>
28 <arg choice='plain' rep='repeat'><group><option>-o </option><replaceable>configoption</replaceable></group></arg>
33 <refsect1><title>DESCRIPTION</title>
34 <para><emphasis remap='B'>Amtape</emphasis>
35 performs tape changer control operations.
36 It uses the underlying tape changer script defined by the
37 <emphasis remap='B'>tpchanger</emphasis>
38 option for a particular &A;
39 configuration as specified by the
40 <emphasis remap='I'>config</emphasis>
43 <para>Tape changers maintain a notion of the
44 <emphasis remap='I'>current</emphasis>
46 <emphasis remap='I'>next</emphasis>
47 slot for each configuration.
48 These may or may not correspond to an actual physical state of the device,
49 but do tend to minimize searching through the tape storage slots.
50 If the desired tape is in the current slot,
51 it is likely the next tape needed is in the next slot
52 rather than at some random position in the storage slots.</para>
55 <citerefentry><refentrytitle>amanda</refentrytitle><manvolnum>8</manvolnum></citerefentry>
56 man page for more details about &A;.</para>
59 <refsect1><title>COMMANDS</title>
60 <variablelist remap='TP'>
62 <term><emphasis remap='B'>reset</emphasis></term>
64 <para>Reset the tape changer to a known state.
66 <emphasis remap='I'>current</emphasis>
68 <emphasis remap='I'>first</emphasis>
70 Other device-specific side effects may occur.
71 Some gravity stackers need to be reset to the top position by hand.
72 This command notifies &A; the stacker is back in that position.</para>
76 <term><emphasis remap='B'>eject</emphasis></term>
78 <para>If a tape is loaded in the drive, it is ejected and returned to the
79 slot from which it was loaded.</para>
83 <term><emphasis remap='B'>clean</emphasis></term>
85 <para>If a cleaning tape is defined for the changer,
86 it is used to clean the drive.</para>
90 <term><emphasis remap='B'>show</emphasis></term>
92 <para>Show the contents of all slots.
93 This can be slow.</para>
97 <term><emphasis remap='B'>label</emphasis> <emphasis remap='I'>label</emphasis></term>
99 <para>Search for and load the &A; tape with label
100 <emphasis remap='I'>label</emphasis>.</para>
104 <term><emphasis remap='B'>taper</emphasis></term>
107 <emphasis remap='B'>taper</emphasis>
109 Load the next tape in the configuration's tape sequence,
110 or a fresh tape with a suitable label.</para>
114 <term><emphasis remap='B'>device</emphasis></term>
116 <para>Display the name of the current tape device on
117 <emphasis remap='I'>stdout</emphasis>.</para>
121 <term><emphasis remap='B'>current</emphasis></term>
123 <para>Display the current slot.</para>
127 <term><emphasis remap='B'>update</emphasis></term>
129 <para>Update the changer label database, if it has one,
130 to match the tapes now available.</para>
134 <term><emphasis remap='B'>slot</emphasis> <emphasis remap='I'>slot</emphasis></term>
136 <para>Eject any tape in the drive and put it away,
137 then load the tape from slot
138 <emphasis remap='I'>slot</emphasis>
140 <emphasis remap='I'>current</emphasis>.</para>
144 <term><emphasis remap='B'>slot current</emphasis></term>
146 <para>Eject any tape in the drive and put it away,
147 then load the tape from the current slot.</para>
151 <term><emphasis remap='B'>slot prev</emphasis></term>
153 <para>Eject any tape in the drive and put it away,
154 then load the tape from the previous slot and reset
155 <emphasis remap='I'>current</emphasis>.</para>
159 <term><emphasis remap='B'>slot next</emphasis></term>
161 <para>Eject any tape in the drive and put it away,
162 then load the tape from the next slot and reset
163 <emphasis remap='I'>current</emphasis>.</para>
167 <term><emphasis remap='B'>slot first</emphasis></term>
169 <para>Eject any tape in the drive and put it away,
170 then load the tape from the first slot and reset
171 <emphasis remap='I'>current</emphasis>.</para>
175 <term><emphasis remap='B'>slot last</emphasis></term>
177 <para>Eject any tape in the drive and put it away,
178 then load the tape from the last slot and reset
179 <emphasis remap='I'>current</emphasis>.</para>
183 <term><emphasis remap='B'>slot advance</emphasis></term>
185 <para>Eject any tape in the drive and put it away.
187 <emphasis remap='I'>current</emphasis>
188 to the next tape, but do not load it.</para>
193 <term><emphasis remap='B'>-o</emphasis> <replaceable>configoption</replaceable></term>
195 <para>See the "<emphasis remap='B'>CONFIGURATION OVERRIDE</emphasis>"
196 section in <citerefentry><refentrytitle>amanda</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
202 <para>This is useful with non-gravity stackers to unload the last tape used
203 and set up &A; for the next run.
205 <emphasis remap='B'>eject</emphasis>,
206 the current tape will be mounted again in the next run,
207 where it will be rejected as being still in use,
208 ejected and the next tape requested.
210 <emphasis remap='B'>slot next</emphasis>
212 <emphasis remap='B'>eject</emphasis>
213 does an unnecessary mount.</para>
215 <para>Note: most changers optimize the
216 <emphasis remap='B'>slot</emphasis>
217 commands to not eject the loaded tape if it is the one being requested.</para>
220 <refsect1><title>AUTHOR</title>
221 <para>James da Silva, &email.jds; : Original text</para>
222 <para>&maintainer.sgw;: XML-conversion</para>
225 <refsect1><title>SEE ALSO</title>
226 <para><citerefentry><refentrytitle>amanda</refentrytitle><manvolnum>8</manvolnum></citerefentry></para>