Imported Upstream version 3.1.0
[debian/amanda] / man / xml-source / amcleanup.8.xml
index 76c9f1d45f26179aaa907aacac2e50d125d53171..dfc11f1c8e49d7cb8d528579ffea7bfcdeb4f1ab 100644 (file)
@@ -3,7 +3,7 @@
                    "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>amcleanup</refentrytitle>
 <manvolnum>8</manvolnum>
+&rmi.source;
+&rmi.version;
+&rmi.manual.8;
 </refmeta>
 <refnamediv>
 <refname>amcleanup</refname>
-<refpurpose>run the &A; cleanup process after a failure</refpurpose>
+<refpurpose>run the Amanda cleanup process after a failure</refpurpose>
 </refnamediv>
+<refentryinfo>
+&author.jds;
+&author.sgw.xml;
+</refentryinfo>
 <!-- body begins here -->
 <refsynopsisdiv>
 <cmdsynopsis>
   <command>amcleanup</command>    
     <arg choice='opt'><option>-k</option></arg>
+    <arg choice='opt'><option>-p</option></arg>
     <arg choice='opt'><option>-v</option></arg>
     <arg choice='plain'><replaceable>config</replaceable></arg>
 </cmdsynopsis>
@@ -32,8 +40,8 @@
 <refsect1><title>DESCRIPTION</title>
 <para><emphasis remap='B'>Amcleanup</emphasis>
 generates the
-<emphasis remap='I'>&A; Mail Report</emphasis>
-and updates the &A; databases after a system failure on a tape server host.
+<emphasis remap='I'>Amanda Mail Report</emphasis>
+and updates the Amanda databases after a system failure on a tape server host.
 This cleanup process is normally done automatically as part of the
 <emphasis remap='B'>amdump</emphasis>
 program, but if
@@ -43,8 +51,8 @@ cannot complete for some reason (usually because of a tape server host crash),
 must be run some time later (usually during system boot).</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>
@@ -52,7 +60,13 @@ man page for more details about &A;.</para>
   <varlistentry>
   <term><option>-k</option></term>
   <listitem>
-   <para>Kill all Amanda processes.</para>
+   <para>Kill all process listed in the log file are their child. if there is no log file, then kill all amdump and amflush process and their child.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-p</option></term>
+  <listitem>
+   <para>Do the cleanup only if all process listed in the log file are already terminated.</para>
   </listitem>
   </varlistentry>
   <varlistentry>
@@ -65,7 +79,7 @@ man page for more details about &A;.</para>
 </refsect1>
 
 <refsect1><title>EXAMPLES</title>
-<para>This example runs the &A; cleanup process by hand after
+<para>This example runs the Amanda cleanup process by hand after
 a failure.</para>
 
 <programlisting>
@@ -74,7 +88,7 @@ a failure.</para>
 
 <para>Putting the following line in a system boot script (e.g.
 <filename>/etc/rc.local</filename>)
-runs the &A; cleanup process as part of the reboot,
+runs the Amanda cleanup process as part of the reboot,
 eliminating the need to run it by hand.</para>
 
 <programlisting>
@@ -90,16 +104,9 @@ amcleanup: no unprocessed logfile to clean up.
 </programlisting>
 </refsect1>
 
-<refsect1><title>AUTHOR</title>
-<para>James da Silva, &email.jds;: Original text</para>
-<para>&maintainer.sgw;: XML-conversion</para>
-</refsect1>
+<seealso>
+<manref name="amdump" vol="8"/>
+</seealso>
 
-<refsect1><title>SEE ALSO</title>
-<para><citerefentry><refentrytitle>amanda</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
-<citerefentry><refentrytitle>amdump</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
-<ulink url="http://wiki.zmanda.com"/>
-</para>
-</refsect1>
 </refentry>