3 .\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/>
8 .TH "AMLABEL" "8" "03/31/2008" "" ""
9 .\" disable hyphenation
11 .\" disable justification (adjust text to left margin only)
14 amlabel - label an Amanda tape
17 \fBamlabel\fR [\-f] \fIconfig\fR \fIlabel\fR [slot\ \fIslot\fR] [\-o\ \fIconfigoption\fR]...
22 tapes must be pre\-labeled before they are used\.
28 before writing to make sure the proper tape is loaded\.
33 label on the tape in the device specified by the
35 file in /usr/local/etc/amanda/\fIconfig\fR\.
37 may be any string that does not contain whitespace and that matches the
40 regular expression option\. It is up to the system administrator to define a naming convention\.
43 appends the new tape to the
45 file so it will be used by
47 before it reuses any other tapes\. When you
49 multiple tapes, they will be used in the order you
54 will not write the label if the tape contains an active
56 tape or if the label specified is on an active tape\. The
58 (force) flag bypasses these verifications\.
62 may be specified after the tape label\. If a tape changer is in use,
64 will label the tape in the specified slot instead of the currently loaded tape\.
68 man page for more details about
72 \fB\-o\fR \fIconfigoption\fR
74 See the "\fBCONFIGURATION OVERRIDE\fR" section in
81 label with the string "DMP000" on the tape loaded in the device named in the
83 option in /usr/local/etc/amanda/daily/amanda\.conf:
87 % amlabel daily DMP000
91 Label the tape in slot 3 of the currently configured tape changer with the string "DMP003":
95 % amlabel daily DMP003 slot 3
100 label \fIlabel\fR doesn\'t match labelstr \fIstr\fR
104 on the command line does not match the
112 label \fIlabel\fR already on a tape
116 is already listed as an active
121 no tpchanger specified in \fIpath\fR , so slot command invalid
123 The command line has the
129 does not have a tape changer configured\.
132 reading label \fIlabel\fR, tape is in another amanda configuration
134 This tape appears to be a valid
136 tape, but label does not match
138 for this configuration so it is probably part of a different
143 reading label \fIlabel\fR, tape is active
147 appears to already be part of this
149 configuration and active, i\.e\. has valid data on it\.
152 no label found, are you sure \fItape\fR is non\-rewinding?
154 While checking that the label was written correctly,
156 got an error that might be caused by mis\-configuring
158 with a rewinding tape device name instead of a non\-rewinding device name for
164 <jds@amanda\.org>: Original text
166 Stefan G\. Weichinger,
167 <sgw@amanda\.org>, maintainer of the
168 \fIAmanda\fR\-documentation: XML\-conversion
174 \fBhttp://wiki.zmanda.com\fR()