git.gag.com Git - debian/amanda/blob - man/xml-source/amrmtape.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='amrmtape.8'>
  12
  13 <refmeta>
  14 <refentrytitle>amrmtape</refentrytitle>
  15 <manvolnum>8</manvolnum>
  16 &rmi.source;
  17 &rmi.version;
  18 &rmi.manual.8;
  19 </refmeta>
  20 <refnamediv>
  21 <refname>amrmtape</refname>
  22 <refpurpose>remove a tape from the &A; database</refpurpose>
  23 </refnamediv>
  24 <refentryinfo>
  25 &author.atf3r;
  26 &author.sgw.xml;
  27 </refentryinfo>
  28 <!-- body begins here -->
  29 <refsynopsisdiv>
  30 <cmdsynopsis>
  31   <command>amrmtape</command>
  32     <arg choice='opt'>-n </arg>
  33     <arg choice='opt'>-v </arg>
  34     <arg choice='opt'>-q </arg>
  35     <arg choice='opt'>-d </arg>
  36     <arg choice='plain'><replaceable>config</replaceable></arg>
  37     <arg choice='plain'><replaceable>label</replaceable></arg>
  38 </cmdsynopsis>
  39 </refsynopsisdiv>
  40
  41
  42 <refsect1><title>DESCRIPTION</title>
  43 <para><emphasis remap='B'>Amrmtape</emphasis>
  44 invalidates the contents of an existing backup tape
  45 in the configuration database.
  46 This is meant as a recovery mechanism when a
  47 good backup is damaged either by faulty hardware or user error,
  48 e.g. the tape is eaten by the drive or is overwritten.</para>
  49
  50 <para>See the
  51 <citerefentry><refentrytitle>amanda</refentrytitle><manvolnum>8</manvolnum></citerefentry>
  52 man page for more details about &A;.</para>
  53 </refsect1>
  54
  55 <refsect1><title>OPTIONS</title>
  56 <variablelist remap='TP'>
  57   <varlistentry>
  58   <term><option>-n</option></term>
  59   <listitem>
  60 <para>Generate new &tapelist; and database files with
  61 <emphasis remap='I'>label</emphasis>
  62 removed, but leave them in
  63 <filename>/tmp</filename>
  64 and do not update the original copies.</para>
  65   </listitem>
  66   </varlistentry>
  67   <varlistentry>
  68   <term><option>-v</option></term>
  69   <listitem>
  70 <para>List backups of hosts and disks that are being discarded.  Enabled by default.</para>
  71   </listitem>
  72   </varlistentry>
  73   <varlistentry>
  74   <term><option>-q</option></term>
  75   <listitem>
  76 <para>Opposite of
  77 <option>-v</option>.</para>
  78   </listitem>
  79   </varlistentry>
  80   <varlistentry>
  81   <term><option>-d</option></term>
  82   <listitem>
  83 <para>Run in debugging mode so all executed commands are shown.</para>
  84   </listitem>
  85   </varlistentry>
  86 </variablelist>
  87 </refsect1>
  88
  89 <refsect1><title>EXAMPLE</title>
  90 <para>Remove tape labeled
  91 <emphasis remap='I'>DAILY034</emphasis>
  92 from the
  93 <emphasis remap='I'>DailySet1</emphasis>
  94 configuration.</para>
  95
  96 <programlisting>
  97 # amrmtape DailySet1 DAILY034
  98 </programlisting>
  99 </refsect1>
 100
 101 <refsect1><title>SEE ALSO</title>
 102 <para><citerefentry><refentrytitle>amadmin</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
 103 <citerefentry><refentrytitle>amanda</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
 104 <ulink url="http://wiki.zmanda.com"/>
 105 </para>
 106 </refsect1>
 107 </refentry>
 108