Imported Upstream version 3.2.0

[debian/amanda] / man / xml-source / amanda-changers.7.xml

diff --git a/man/xml-source/amanda-changers.7.xml b/man/xml-source/amanda-changers.7.xml
index 9846a12066e2e942acc5ae0fcfbb6523f3202b37..4827e08113970ff7f3070e5834087867744135f7 100644 (file)
--- a/man/xml-source/amanda-changers.7.xml
+++ b/man/xml-source/amanda-changers.7.xml
@@ -97,7 +97,7 @@ define changer hp-robot {
     tapedev "chg-robot:/dev/sg1"
     property "tape-device" "0=tape:/dev/nst0"
     property append "tape-device" "1=tape:/dev/nst1"
-    device_property "BLOCK_SIZE" "512k"
+    device-property "BLOCK_SIZE" "512k"
 }
 # ...
 tapedev "hp-robot"
@@ -111,7 +111,7 @@ changer definition, as in the <emphasis>hp-robot</emphasis> example, above.</par
 <para>Devices, too, can take properties to control their behavior (see <manref
 name="amanda-devices" vol="7" />).  Device properties can come from four
 places: implicit device properties (from tapetype parameters), global device
-properties (from global <emphasis>device_property</emphasis> parameters),
+properties (from global <emphasis>device-property</emphasis> parameters),
 properties in device definitions, and properties in changer definitions.
 Properties are applied in this order, with later properties taking
 priority.</para>
@@ -183,6 +183,14 @@ all volumes for a configuration have different device names -- for example,
 if you have many standalone drive.  The <emphasis>changerfile</emphasis> must exist; it is used to save the state file.
 </para>
 
+<para>The child devices are specified using the same syntax as for the RAIT
+device (see <manref name="amanda-changers" vol="7"/>).  The range
+specification can be especially useful here:
+<programlisting>
+tpchanger "chg-multi:s3:mycompany-backups/tape-{001..100}"
+</programlisting>
+</para>
+
 <para>This changer is not fast-search capable.</para>
 
 <refsect3><title>Properties</title>
@@ -359,8 +367,10 @@ define changer robot {
 tpchanger "chg-rait:{vtape,robot}"
 </programlisting>
 
-<para>This changer script constructs RAIT devices out of the devices provided by several "sub-changers".  The sub-changers are specified using the same shell-like syntax as the RAIT device (see
-<manref name="amanda-devices" vol="7"/>).</para>
+<para>This changer script constructs RAIT devices out of the devices provided
+by several "sub-changers".  The sub-changers are specified using the same
+shell-like syntax as the RAIT device (see <manref name="amanda-devices"
+    vol="7"/>).</para>
 
 <para>Chg-rait does not require that all of the child changers have the same slot names: compound slot names are created by combining the slot names supplied by the child changers using the same shell-like syntax.  For example, if the child changers return slots "<computeroutput>top</computeroutput>", "<computeroutput>strange</computeroutput>", and "<computeroutput>3</computeroutput>", then the RAIT changer will return "<computeroutput>{top,strange,3}</computeroutput>".  This makes it possible to, for example, mirror data on tapes in slots 1-10 to tapes in slots 11-20 of the same robot, using two <command>chg-zd-mtx</command> child changers (and, naturally, two tape drives).  In this arrangement, the first slot would be named <computeroutput>{1,11}</computeroutput>.</para>
 
@@ -667,6 +677,10 @@ The password for the NDMP server.
 The username for the NDMP server.
 </listitem></varlistentry>
 <!-- ==== -->
+<varlistentry><term>VERBOSE</term><listitem>
+If true, enables the NDMJOB library's verbose (packet-level) debugging.
+</listitem></varlistentry>
+<!-- ==== -->
 </variablelist>
 
 </refsect3>