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='ammt.8'>
14 <refentrytitle>ammt</refentrytitle>
15 <manvolnum>8</manvolnum>
18 <refname>ammt</refname>
19 <refpurpose>&A; version of mt</refpurpose>
21 <!-- body begins here -->
24 <command>ammt</command>
25 <arg choice='opt'>-d </arg>
26 <group choice='opt'><arg choice='plain'>-f </arg><arg choice='plain'>-t </arg><arg choice='plain'><replaceable>device</replaceable></arg></group>
27 <arg choice='plain'><replaceable>command</replaceable></arg>
28 <arg choice='opt'><replaceable>count</replaceable></arg>
33 <refsect1><title>DESCRIPTION</title>
34 <para><emphasis remap='B'>Ammt</emphasis>
35 provides just enough of the standard UNIX
36 <emphasis remap='B'>mt</emphasis>
37 command for the needs of &A;.
38 This is handy when doing a full restore and the standard
39 <emphasis remap='B'>mt</emphasis>
40 program has not yet been found.</para>
42 <para><emphasis remap='B'>Ammt</emphasis>
43 also provides access to the &A; output drivers that support
44 various tape simulations.</para>
47 <citerefentry><refentrytitle>amanda</refentrytitle><manvolnum>8</manvolnum></citerefentry>
48 man page for more details about &A;.
50 <emphasis remap='B'>OUTPUT DRIVERS</emphasis>
52 <emphasis remap='I'>amanda(8)</emphasis>
53 for more information on the &A; output drivers.</para>
56 <refsect1><title>OPTIONS</title>
57 <variablelist remap='TP'>
59 <term><option>-d</option></term>
61 <para>Turn on debugging output.</para>
65 <term><option>-f</option><replaceable> device</replaceable></term>
67 <para>Access tape device
68 <emphasis remap='I'>device</emphasis>.
70 <emphasis remap='B'>TAPE</emphasis>
71 environment variable is used.</para>
75 <term><option>-t</option><replaceable> device</replaceable></term>
78 <option>-f</option>.</para>
82 <term><emphasis remap='B'>command</emphasis><emphasis remap='I'> count</emphasis></term>
84 <para>Which command to issue, and an optional count of operations.</para>
90 <refsect1><title>COMMANDS</title>
91 <para>Each command may be abbreviated to whatever length makes it unique.</para>
92 <variablelist remap='TP'>
94 <term><emphasis remap='B'>eof|weof</emphasis><emphasis remap='I'> count</emphasis></term>
97 <emphasis remap='I'>count</emphasis>
98 (default: 1) end of file marks (tapemarks).</para>
102 <term><emphasis remap='B'>fsf</emphasis><emphasis remap='I'> count</emphasis></term>
105 <emphasis remap='I'>count</emphasis>
106 (default: 1) files.</para>
110 <term><emphasis remap='B'>bsf</emphasis><emphasis remap='I'> count</emphasis></term>
113 <emphasis remap='I'>count</emphasis>
114 (default: 1) files.</para>
118 <term><emphasis remap='B'>asf</emphasis><emphasis remap='I'> count</emphasis></term>
120 <para>Position to file number
121 <emphasis remap='I'>count</emphasis>
123 where zero is beginning of tape.
124 This is the same as a
125 <emphasis remap='B'>rewind</emphasis>
127 <emphasis remap='B'>fsf</emphasis>
128 <emphasis remap='I'>count</emphasis>.</para>
132 <term><emphasis remap='B'>rewind</emphasis></term>
134 <para>Rewind to beginning of tape.</para>
138 <term><emphasis remap='B'>offline|rewoffl</emphasis></term>
140 <para>Rewind to beginning of tape and unload the tape from the drive.</para>
144 <term><emphasis remap='B'>status</emphasis></term>
146 <para>Report status information about the drive.
147 Which data reported, and what it means,
148 depends on the underlying operating system,
149 and may include:</para>
150 <variablelist remap='TP'>
154 <para>Indicates the drive is online and ready.</para>
160 <para>Indicates the drive is offline or not ready.</para>
166 <para>Indicates the drive is at beginning of tape.</para>
172 <para>Indicates the drive is at end of tape.</para>
176 <term>PROTECTED</term>
178 <para>Indicates the tape is write protected.</para>
184 <para>Device status.</para>
190 <para>Error register.</para>
196 <para>Current tape file number.</para>
202 <para>Current tape block number file.</para>
210 <note><para>Many systems only report good data when a tape is in the drive and ready.</para>
214 <refsect1><title>AUTHOR</title>
215 <para>Marc Mengel <email>mengel@fnal.gov</email>, John R. Jackson
216 <email>jrj@purdue.edu</email>: Original text</para>
217 <para>&maintainer.sgw;: XML-conversion</para>
220 <refsect1><title>SEE ALSO</title>
221 <para><citerefentry><refentrytitle>amanda</refentrytitle><manvolnum>8</manvolnum></citerefentry></para>