git.gag.com Git - debian/amanda/blob - man/xml-source/ammt.8.xml

   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"
   4 [
   5   <!-- entities files to use -->
   6   <!ENTITY % global_entities SYSTEM '../entities/global.entities'>
   7   %global_entities;
   8 ]>
   9
  10 <!-- lifted from troff+man by doclifter -->
  11 <refentry id='ammt.8'>
  12
  13 <refmeta>
  14 <refentrytitle>ammt</refentrytitle>
  15 <manvolnum>8</manvolnum>
  16 </refmeta>
  17 <refnamediv>
  18 <refname>ammt</refname>
  19 <refpurpose>&A; version of mt</refpurpose>
  20 </refnamediv>
  21 <!-- body begins here -->
  22 <refsynopsisdiv>
  23 <cmdsynopsis>
  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>
  29 </cmdsynopsis>
  30 </refsynopsisdiv>
  31
  32
  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>
  41
  42 <para><emphasis remap='B'>Ammt</emphasis>
  43 also provides access to the &A; output drivers that support
  44 various tape simulations.</para>
  45
  46 <para>See the
  47 <citerefentry><refentrytitle>amanda</refentrytitle><manvolnum>8</manvolnum></citerefentry>
  48 man page for more details about &A;.
  49 See the
  50 <emphasis remap='B'>OUTPUT DRIVERS</emphasis>
  51 section of
  52 <emphasis remap='I'>amanda(8)</emphasis>
  53 for more information on the &A; output drivers.</para>
  54 </refsect1>
  55
  56 <refsect1><title>OPTIONS</title>
  57 <variablelist remap='TP'>
  58   <varlistentry>
  59   <term><option>-d</option></term>
  60   <listitem>
  61 <para>Turn on debugging output.</para>
  62   </listitem>
  63   </varlistentry>
  64   <varlistentry>
  65   <term><option>-f</option><replaceable> device</replaceable></term>
  66   <listitem>
  67 <para>Access tape device
  68 <emphasis remap='I'>device</emphasis>.
  69 If not specified, the
  70 <emphasis remap='B'>TAPE</emphasis>
  71 environment variable is used.</para>
  72   </listitem>
  73   </varlistentry>
  74   <varlistentry>
  75   <term><option>-t</option><replaceable> device</replaceable></term>
  76   <listitem>
  77 <para>Same as
  78 <option>-f</option>.</para>
  79   </listitem>
  80   </varlistentry>
  81   <varlistentry>
  82   <term><emphasis remap='B'>command</emphasis><emphasis remap='I'> count</emphasis></term>
  83   <listitem>
  84 <para>Which command to issue, and an optional count of operations.</para>
  85   </listitem>
  86   </varlistentry>
  87 </variablelist>
  88 </refsect1>
  89
  90 <refsect1><title>COMMANDS</title>
  91 <para>Each command may be abbreviated to whatever length makes it unique.</para>
  92 <variablelist remap='TP'>
  93   <varlistentry>
  94   <term><emphasis remap='B'>eof|weof</emphasis><emphasis remap='I'> count</emphasis></term>
  95   <listitem>
  96 <para>Write
  97 <emphasis remap='I'>count</emphasis>
  98 (default: 1) end of file marks (tapemarks).</para>
  99   </listitem>
 100   </varlistentry>
 101   <varlistentry>
 102   <term><emphasis remap='B'>fsf</emphasis><emphasis remap='I'> count</emphasis></term>
 103   <listitem>
 104 <para>Skip forward
 105 <emphasis remap='I'>count</emphasis>
 106 (default: 1) files.</para>
 107   </listitem>
 108   </varlistentry>
 109   <varlistentry>
 110   <term><emphasis remap='B'>bsf</emphasis><emphasis remap='I'> count</emphasis></term>
 111   <listitem>
 112 <para>Skip backward
 113 <emphasis remap='I'>count</emphasis>
 114 (default: 1) files.</para>
 115   </listitem>
 116   </varlistentry>
 117   <varlistentry>
 118   <term><emphasis remap='B'>asf</emphasis><emphasis remap='I'> count</emphasis></term>
 119   <listitem>
 120 <para>Position to file number
 121 <emphasis remap='I'>count</emphasis>
 122 (default: 0)
 123 where zero is beginning of tape.
 124 This is the same as a
 125 <emphasis remap='B'>rewind</emphasis>
 126 followed by a
 127 <emphasis remap='B'>fsf</emphasis>
 128 <emphasis remap='I'>count</emphasis>.</para>
 129   </listitem>
 130   </varlistentry>
 131   <varlistentry>
 132   <term><emphasis remap='B'>rewind</emphasis></term>
 133   <listitem>
 134 <para>Rewind to beginning of tape.</para>
 135   </listitem>
 136   </varlistentry>
 137   <varlistentry>
 138   <term><emphasis remap='B'>offline|rewoffl</emphasis></term>
 139   <listitem>
 140 <para>Rewind to beginning of tape and unload the tape from the drive.</para>
 141   </listitem>
 142   </varlistentry>
 143   <varlistentry>
 144   <term><emphasis remap='B'>status</emphasis></term>
 145   <listitem>
 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'>
 151       <varlistentry>
 152       <term>ONLINE</term>
 153       <listitem>
 154 <para>Indicates the drive is online and ready.</para>
 155       </listitem>
 156       </varlistentry>
 157       <varlistentry>
 158       <term>OFFLINE</term>
 159       <listitem>
 160 <para>Indicates the drive is offline or not ready.</para>
 161       </listitem>
 162       </varlistentry>
 163       <varlistentry>
 164       <term>BOT</term>
 165       <listitem>
 166 <para>Indicates the drive is at beginning of tape.</para>
 167       </listitem>
 168       </varlistentry>
 169       <varlistentry>
 170       <term>EOT</term>
 171       <listitem>
 172 <para>Indicates the drive is at end of tape.</para>
 173       </listitem>
 174       </varlistentry>
 175       <varlistentry>
 176       <term>PROTECTED</term>
 177       <listitem>
 178 <para>Indicates the tape is write protected.</para>
 179       </listitem>
 180       </varlistentry>
 181       <varlistentry>
 182       <term>ds</term>
 183       <listitem>
 184 <para>Device status.</para>
 185       </listitem>
 186       </varlistentry>
 187       <varlistentry>
 188       <term>er</term>
 189       <listitem>
 190 <para>Error register.</para>
 191       </listitem>
 192       </varlistentry>
 193       <varlistentry>
 194       <term>fileno</term>
 195       <listitem>
 196 <para>Current tape file number.</para>
 197       </listitem>
 198       </varlistentry>
 199       <varlistentry>
 200       <term>blkno</term>
 201       <listitem>
 202 <para>Current tape block number file.</para>
 203       </listitem>
 204       </varlistentry>
 205     </variablelist>
 206   </listitem>
 207   </varlistentry>
 208 </variablelist>
 209
 210 <note><para>Many systems only report good data when a tape is in the drive and ready.</para>
 211 </note>
 212 </refsect1>
 213
 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>
 218 </refsect1>
 219
 220 <refsect1><title>SEE ALSO</title>
 221 <para><citerefentry><refentrytitle>amanda</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
 222  <ulink url="http://wiki.zmanda.com"/>
 223 </para>
 224 </refsect1>
 225 </refentry>
 226