Imported Upstream version 3.3.0

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

diff --git a/man/xml-source/amlabel.8.xml b/man/xml-source/amlabel.8.xml
index 66046ac4fc259872538636fb22e4cb3bcb661292..62b677369bbd20b3643bd125a4541442b3314729 100644 (file)
--- a/man/xml-source/amlabel.8.xml
+++ b/man/xml-source/amlabel.8.xml
@@ -30,11 +30,14 @@
 <refsynopsisdiv>
 <cmdsynopsis>
   <command>amlabel</command>    
+    <arg choice='opt'><option>--barcode <replaceable>barcode</replaceable></option></arg>
+    <arg choice='opt'><option>--meta <replaceable>meta-label</replaceable></option></arg>
+    <arg><option>--assign</option></arg>
     <arg><option>-f</option></arg>
     &version.synopsis;
     &configoverride.synopsis;
     <arg choice='plain'><replaceable>config</replaceable></arg>
-    <arg choice='plain'><replaceable>label</replaceable></arg>
+    <arg choice='opt'><replaceable>label</replaceable></arg>
     <arg choice='opt'>slot <replaceable>slot</replaceable></arg>
 </cmdsynopsis>
 </refsynopsisdiv>
@@ -49,13 +52,17 @@ and <manref name="amflush" vol="8" /> verify the label before writing to make
 sure the proper volume is loaded, and the recovery programs use the label to
 ensure they are reading the data they expect.</para>
 
-<para>If no <arg choice="opt"><replaceable>slot</replaceable></arg> is given,
+<para>If no <arg choice="opt"><replaceable>slot</replaceable></arg> and no <arg choice="opt"><replaceable>barcode</replaceable></arg> is given,
 then <command>amlabel</command> labels the tape in the current slot of the
-default changer.  If a slot is given, it labels the volume in that slot.
+default changer.  If a slot is given, it labels the volume in that slot. If a barcode is given, it labels the volume with that barcode.
 <emphasis remap='I'>Label</emphasis> may be any string that does not contain
 whitespace and that matches the <emphasis remap='B'>labelstr</emphasis> (see
 <manref name="amanda.conf" vol="5" />).</para>
 
+<para>If <arg choice="opt"><replaceable>label</replaceable></arg> is not given, an autolabel is
+generated, see <emphasis remap='B'>autolabel</emphasis> in <manref name="amanda.conf" vol="5"/>.</para>
+
+<para>If <arg><option>--assign</option></arg> is given, the barcode and meta-label are assigned to the label without labeling the volume. The label must already be in the tapelist file.</para>
 <para>This command also appends the new volume to the &tapelist; file, so that
 they will be used in the order they are labeled (depending on the taperscan in
 use &mdash; see <manref name="amanda-taperscan" vol="7" />).</para>
@@ -69,6 +76,28 @@ verifications.</para>
 <refsect1><title>OPTIONS</title>
 <variablelist remap='TP'>
 
+  <varlistentry>
+  <term><option>--barcode <replaceable>barcode</replaceable></option></term>
+  <listitem>
+  <para>With <arg choice="opt">--assign</arg>, assign the barcode to the label.
+Without <arg choice="opt">--assign</arg>, label the volume with that barcode.</para>
+  </listitem>
+  </varlistentry>
+
+  <varlistentry>
+  <term><option>--meta <replaceable>meta-label</replaceable></option></term>
+  <listitem>
+  <para>Assign the meta label to the label after labeling the volume.</para>
+  </listitem>
+  </varlistentry>
+
+  <varlistentry>
+  <term><option>--assign</option></term>
+  <listitem>
+  <para>Assign the barcode or meta-label to the label without labeling the volume. The label must already be in the tapelist file.</para>
+  </listitem>
+  </varlistentry>
+
   <varlistentry>
   <term><option>-f</option></term>
   <listitem>