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