X-Git-Url: https://git.gag.com/?a=blobdiff_plain;f=man%2Fxml-source%2Famlabel.8.xml;h=62b677369bbd20b3643bd125a4541442b3314729;hb=cd0b924f27312d57bd42f6c4fae2b795139e2d0b;hp=c36ee0e65fe2a67ef10be8d5267f2a448d1edd1e;hpb=d3b2175e084f88c8736ad7073eacbf4670147aec;p=debian%2Famanda diff --git a/man/xml-source/amlabel.8.xml b/man/xml-source/amlabel.8.xml index c36ee0e..62b6773 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; ]> @@ -13,98 +13,114 @@ amlabel 8 +&rmi.source; +&rmi.version; +&rmi.manual.8; amlabel -label an &A; tape +label an Amanda tape + +&author.jds; +&author.sgw.xml; +&author.dustin; + amlabel - -f + + + + + &version.synopsis; + &configoverride.synopsis; config - label + label slot slot - -o configoption - 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 and no barcode 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. If a barcode is given, it labels the volume with that barcode. +Label may be any string that does not contain +whitespace and that matches the labelstr (see +). + +If label is not given, an autolabel is +generated, see autolabel in . + +If 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. +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 - -o configoption + + + With --assign, assign the barcode to the label. +Without --assign, label the volume with that barcode. + + + + + + + Assign the meta label to the label after labeling the volume. + + + + + -See the "CONFIGURATION OVERRIDE" section in amanda8. + Assign the barcode or meta-label to the label without labeling the volume. The label must already be in the tapelist file. + + + + 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 @@ -113,80 +129,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. - + + -AUTHOR -James da Silva, &email.jds;: Original text -&maintainer.sgw;: XML-conversion - + + + + +, + + -SEE ALSO -amanda8 -amdump8 -amflush8 -