"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"
[
<!-- entities files to use -->
- <!ENTITY % global_entities SYSTEM '../entities/global.entities'>
+ <!ENTITY % global_entities SYSTEM 'global.entities'>
%global_entities;
]>
<refmeta>
<refentrytitle>amrmtape</refentrytitle>
<manvolnum>8</manvolnum>
+&rmi.source;
+&rmi.version;
+&rmi.manual.8;
</refmeta>
<refnamediv>
<refname>amrmtape</refname>
-<refpurpose>remove a tape from the &A; database</refpurpose>
+<refpurpose>remove a tape from the Amanda database</refpurpose>
</refnamediv>
+<refentryinfo>
+&author.atf3r;
+&author.sgw.xml;
+</refentryinfo>
<!-- body begins here -->
<refsynopsisdiv>
<cmdsynopsis>
- <command>amrmtape</command>
+ <command>amrmtape</command>
+ <arg choice='opt'>--changer <replaceable>changer-name</replaceable> </arg>
+ <arg choice='opt'>--cleanup </arg>
+ <arg choice='opt'>--dryrun </arg>
<arg choice='opt'>-n </arg>
- <arg choice='opt'>-v </arg>
+ <arg choice='opt'>--erase </arg>
+ <arg choice='opt'>--keep-label </arg>
+ <arg choice='opt'>--quiet </arg>
<arg choice='opt'>-q </arg>
- <arg choice='opt'>-d </arg>
+ <arg choice='opt'>--verbose </arg>
+ <arg choice='opt'>-v </arg>
<arg choice='plain'><replaceable>config</replaceable></arg>
<arg choice='plain'><replaceable>label</replaceable></arg>
</cmdsynopsis>
e.g. the tape is eaten by the drive or is overwritten.</para>
<para>See the
-<citerefentry><refentrytitle>amanda</refentrytitle><manvolnum>8</manvolnum></citerefentry>
-man page for more details about &A;.</para>
+<manref name="amanda" vol="8"/>
+man page for more details about Amanda.</para>
</refsect1>
<refsect1><title>OPTIONS</title>
<variablelist remap='TP'>
<varlistentry>
+ <term><option>--changer <replaceable>changer-name</replaceable> </option></term>
+ <listitem>
+<para>Specify which changer to use when erasing
+<emphasis remap='I'>label</emphasis>
+</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--cleanup</option></term>
+ <listitem>
+<para>Remove logs and indexes associated with
+<emphasis remap='I'>label</emphasis>.
+Otherwise, they'll remain until the next run of amdump.
+</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--dryrun</option></term>
<term><option>-n</option></term>
<listitem>
-<para>Generate new
-<emphasis remap='I'>tapelist</emphasis>
-and database files with
+<para>Generate new &tapelist; and database files with
<emphasis remap='I'>label</emphasis>
removed, but leave them in
<filename>/tmp</filename>
</listitem>
</varlistentry>
<varlistentry>
+ <term><option>--erase</option></term>
+ <listitem>
+<para>Attempt to erase the data contained on the volume with the given label.
+This requires that Amanda be able to find that volume using the tape changer.
+Erasure is not supported by all Amanda devices, and the erasure is not "secure"
+in the sense that the data can most likely be recovered by someone with the
+right tools. </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--keep-label</option></term>
+ <listitem>
+<para>Do not remove
+<emphasis remap='I'>label</emphasis>
+from the tapelist.
+</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--verbose</option></term>
<term><option>-v</option></term>
<listitem>
<para>List backups of hosts and disks that are being discarded. Enabled by default.</para>
</listitem>
</varlistentry>
<varlistentry>
+ <term><option>--quiet</option></term>
<term><option>-q</option></term>
<listitem>
<para>Opposite of
<option>-v</option>.</para>
</listitem>
</varlistentry>
- <varlistentry>
- <term><option>-d</option></term>
- <listitem>
-<para>Run in debugging mode so all executed commands are shown.</para>
- </listitem>
- </varlistentry>
</variablelist>
</refsect1>
</programlisting>
</refsect1>
-<refsect1><title>AUTHOR</title>
-<para>Adrian T. Filipi-Martin <email>atf3r@cs.virginia.edu</email>: Original text</para>
-<para>&maintainer.sgw;: XML-conversion</para>
-</refsect1>
+<seealso>
+<manref name="amadmin" vol="8"/>
+</seealso>
-<refsect1><title>SEE ALSO</title>
-<para><citerefentry><refentrytitle>amadmin</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
-<citerefentry><refentrytitle>amanda</refentrytitle><manvolnum>8</manvolnum></citerefentry></para>
-</refsect1>
</refentry>
-