X-Git-Url: https://git.gag.com/?a=blobdiff_plain;f=man%2Fxml-source%2Famlabel.8.xml;fp=man%2Fxml-source%2Famlabel.8.xml;h=3882882520cb7f8bad9d3bf9a7813bfb6abbf14c;hb=d5853102f67d85d8e169f9dbe973ad573306c215;hp=3e46026a55606882f4728f5544b917c57d90714f;hpb=b93e5b5a13be7e970bc333acbe885f5b518300e1;p=debian%2Famanda
diff --git a/man/xml-source/amlabel.8.xml b/man/xml-source/amlabel.8.xml
index 3e46026..3882882 100644
--- a/man/xml-source/amlabel.8.xml
+++ b/man/xml-source/amlabel.8.xml
@@ -3,7 +3,7 @@
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"
[
-
+
%global_entities;
]>
@@ -19,98 +19,79 @@
amlabel
-label an &A; tape
+label an Amanda tape
&author.jds;
&author.sgw.xml;
+&author.dustin;
amlabel
- -f configlabelslot slot
- -o configoption
+
+ &version.synopsis;
+ &configoverride.synopsis;
-
DESCRIPTION
-All &A; tapes must be pre-labeled before they are used.
-&A; verifies the label in
-amdump
-and
-amflush
-before writing to make sure the proper tape is loaded.
-
-Amlabel
-writes an &A; label on the tape in the device specified by the
-amanda.conf
-file in /usr/local/etc/amanda/config.
-Label
-may be any string that does not contain whitespace and that matches the
-amanda.conf
-labelstr
-regular expression option.
-It is up to the system administrator to define a naming convention.
-
-Amlabel
-appends the new tape to the &tapelist;
-file so it will be used by &A; before it reuses any other tapes.
-When you
-amlabel
-multiple tapes, they will be used in the order you
-amlabel
-them.
-
-Amlabel
-will not write the label if the tape contains an active
-&A; tape or if the label specified is on an active tape.
-The
-
-(force) flag bypasses these verifications.
-
-An optional
-slot
-may be specified after the tape label.
-If a tape changer is in use,
-amlabel
-will label the tape in the specified slot instead of the currently loaded tape.
-
-See the
-amanda8
-man page for more details about &A;.
+
+This command applies a label to an Amanda volume, erasing the volume in
+the process.
+
+Amanda uses labels to identify volumes:
+and 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.
+
+If no slot is given,
+then amlabel labels the tape in the current slot of the
+default changer. If a slot is given, it labels the volume in that slot.
+Label may be any string that does not contain
+whitespace and that matches the labelstr (see
+).
+
+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 — see ).
+
+As a precaution, amlabel will not write a label if the
+volume already contains an active label or if the label specified is on an
+active tape. The -f (force) flag bypasses these
+verifications.OPTIONS
- -oconfigoption
+
-See the "CONFIGURATION OVERRIDE" section in amanda8.
+ Force the label operation; see above
+ &version.varlistentry;
+ &configoverride.varlistentry;
EXAMPLE
-Write an &A; label with the string "DMP000" on
-the tape loaded in the device named in the
-tapedev
-option in /usr/local/etc/amanda/daily/amanda.conf:
+Write an Amanda label with the string "DMP000" on
+the current volume:
% amlabel daily DMP000
-Label the tape in slot 3 of the currently configured tape changer
-with the string "DMP003":
+Label the tape in slot 3 of the changer with the label
+"DMP003":
% amlabel daily DMP003 slot 3
@@ -119,77 +100,60 @@ with the string "DMP003":
MESSAGES
+
- label label doesn't match labelstr str
-
-Label
-label
-on the command line does not match the
-labelstr
-regular expression
-str
-from
-amanda.conf.
-
-
-
- label label already on a tape
-
-Label
-label
-is already listed as an active &A; tape.
-
+
+ Label 'label' doesn't match labelstr
+ 'labelstr'
+
+ The given label does not match the configured labelstr. Even
+ with , this is an error.
+
- no tpchanger specified in path , so slot command invalid
-
-The command line has the
-slot
-parameter but the
-amanda.conf
-file in
-path
-does not have a tape changer configured.
-
+
+ Label 'label' already on a volume
+
+ The given label is already on another volume in the tapelist, and
+ Amanda will not write it to this volume unless forced.
+
- reading label label, tape is in another amanda configuration
-
-This tape appears to be a valid &A; tape,
-but label does not match
-labelstr
-for this configuration so it is probably part of a different &A; configuration.
-
+
+ Found label 'label', but it is not from
+ configuration config.
+
+ The label amlabel found on the volume does
+ not match this configuration's labelstr, so it
+ is probably part of a different Amanda configuration. Amanda will not
+ overwrite the label unless it is forced.
+
- reading label label, tape is active
-
-Tape
-label
-appears to already be part of this &A; configuration
-and active, i.e. has valid data on it.
-
+
+ Volume with label 'label' contains
+ data from this configuration.
+
+ The label amlabel found on the volume
+ still has valid data on it and Amanda will not overwrite it unless
+ forced. Note that this does not distinguish between active and inactive
+ volumes.
+
- no label found, are you sure tape is non-rewinding?
-
-While checking that the label was written correctly,
-amlabel
-got an error that might be caused by mis-configuring &A;
-with a rewinding tape device name
-instead of a non-rewinding device name for
-tape.
-
+
+
-SEE ALSO
-amanda8,
-amdump8,
-amflush8,
-
-
-
+
+
+
+
+,
+
+
+