Imported Upstream version 3.2.0

[debian/amanda] / man / xml-source / amadmin.8.xml

diff --git a/man/xml-source/amadmin.8.xml b/man/xml-source/amadmin.8.xml
index 9f70828bf2bf0d7d104b5f2b25d5b6633c66e290..7bc1f2f641b48a48d6d6770aab8027cf60fb111a 100644 (file)
--- a/man/xml-source/amadmin.8.xml
+++ b/man/xml-source/amadmin.8.xml
@@ -54,17 +54,9 @@ man page for more details about Amanda.</para>
 parameter pair operate on all disks in the &disklist; for that
 <emphasis remap='I'>hostname</emphasis> if no disks are specified.  Where
 <emphasis remap='I'>hostname</emphasis> is also marked as being optional,
-the command operates on all hosts and disks in the &disklist;.
+the command operates on all hosts and disks in the &disklist; when no hostname is given.
 Both <emphasis remap='I'>hostname</emphasis> and <emphasis remap='I'>disks</emphasis>
-are special expressions; see the &quot;HOST &amp; DISK EXPRESSION&quot; section
-of <manref name="amanda" vol="8"/>
-for a description.</para>
-
-<para>Commands that take one or more <emphasis remap='I'>dumpspec</emphasis> parameters operate
-on the set of dumps specified by all of the expressions.  See the &quot;DUMP SPECIFICATIONS&quot;
-section of
-<manref name="amanda" vol="8"/>
-for a description.</para>
+are match expressions; see <manref name="amanda-match" vol="7"/> for a description.</para>
 
 <variablelist remap='TP'>
   <varlistentry>
@@ -220,10 +212,12 @@ The default sort order is <emphasis remap='B'>hkdlpbfw</emphasis>.</para>
   <term><emphasis remap='B'>holding list</emphasis> [-l] [-d] [ <emphasis remap="I">hostname</emphasis> [ <emphasis remap="I">disk</emphasis> [ <emphasis remap="I">datestamp</emphasis> [ .. ] ] ] ]</term>
   <listitem>
 
-    <para>List holding files matching the given specification, or all holding
-    files if no specification is provided.  With '-l', additional information
-    (size, level, and whether the dump is outdated) is provided.  With '-d', only
-    outdated dumps are shown.</para>
+    <para>List holding files matching the given dump specification, or all
+       holding files if no specification is provided.  See <manref
+           name="amanda-match" vol="7"/> for more information on dump
+       specifications.  With '-l', additional information (size, level, and
+       whether the dump is outdated) is provided.  With '-d', only outdated
+       dumps are shown.</para>
 
     <para>An outdated holding file is one which is not required for a
     restore of the <emphasis>most recent</emphasis> dump.  Note that
@@ -299,6 +293,18 @@ on
 <emphasis remap='I'>hostname</emphasis>
 (or all hosts).
 Mostly used for debugging.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>hosts</emphasis></term>
+  <listitem>
+<para>Output a list of distinct hosts in the &disklist;, one per line, for easy use in shell scripts.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><emphasis remap='B'>dles</emphasis></term>
+  <listitem>
+<para>Output a list of distinct DLEs in the &disklist;, one per line with host and diskname separated by a space, for easy use in shell scripts.</para>
   </listitem>
   </varlistentry>
   <varlistentry>
@@ -457,16 +463,13 @@ TOTAL      241  12412187   7316312   731631  (estimated 8 runs per dumpcycle)
 </programlisting>
 </refsect1>
 
-<refsect1><title>FILES</title>
-<para>/usr/local/etc/amanda/<emphasis remap='I'>config</emphasis>/amanda.conf</para>
-</refsect1>
-
 <seealso>
 <manref name="amanda" vol="8"/>,
 <manref name="amcheck" vol="8"/>,
 <manref name="amdump" vol="8"/>,
 <manref name="amrestore" vol="8"/>,
 <manref name="amfetchdump" vol="8"/>
+<manref name="amanda-match" vol="7"/>,
 </seealso>
 
 </refentry>