X-Git-Url: https://git.gag.com/?a=blobdiff_plain;ds=sidebyside;f=man%2Famlabel.8;h=4a77231ee59836182e9c1d26b82d2ee332a60e5c;hb=94c03cae686e4196a345d72452fda2a5203768ce;hp=a9a965cfa1c6d1b49095309d650e885de77230d8;hpb=1194fb66aa28d9929c3f2bef3cc6c1c3f40a60a4;p=debian%2Famanda diff --git a/man/amlabel.8 b/man/amlabel.8 index a9a965c..4a77231 100644 --- a/man/amlabel.8 +++ b/man/amlabel.8 @@ -18,88 +18,139 @@ .IP "\\$1" \\$2 .. .TH "AMLABEL" 8 "" "" "" -.SH NAME -amlabel \- label an Amanda tape +.SH "NAME" +amlabel - label an Amanda tape .SH "SYNOPSIS" -.ad l -.hy 0 .HP 8 -\fBamlabel\fR [\-f] \fIconfig\fR \fIlabel\fR [\fIslot\fR\ \fIslot\fR] -.ad -.hy - +\fBamlabel\fR [-f] \fIconfig\fR \fIlabel\fR [\fIslot\fR \fIslot\fR] .SH "DESCRIPTION" - .PP -All \fBAmanda\fR tapes must be pre\-labeled before they are used\&. \fBAmanda\fR verifies the label in \fBamdump\fR and \fBamflush\fR before writing to make sure the proper tape is loaded\&. - +All +\fBAmanda\fR +tapes must be pre-labeled before they are used. +\fBAmanda\fR +verifies the label in +\fBamdump\fR +and +\fBamflush\fR +before writing to make sure the proper tape is loaded. .PP -\fBAmlabel\fR writes an \fBAmanda\fR label on the tape in the device specified by the \fBamanda\&.conf\fR file in /usr/local/etc/amanda/\fBconfig\fR\&. \fBLabel\fR may be any string that does not contain whitespace and that matches the \fBamanda\&.conf\fR \fBlabelstr\fR regular expression option\&. It is up to the system administrator to define a naming convention\&. - +\fBAmlabel\fR +writes an +\fBAmanda\fR +label on the tape in the device specified by the +\fBamanda.conf\fR +file in /usr/local/etc/amanda/\fBconfig\fR. +\fBLabel\fR +may be any string that does not contain whitespace and that matches the +\fBamanda.conf\fR\fBlabelstr\fR +regular expression option. It is up to the system administrator to define a naming convention. .PP -\fBAmlabel\fR appends the new tape to the \fBtapelist\fR file so it will be used by \fBAmanda\fR before it reuses any other tapes\&. When you \fBamlabel\fR multiple tapes, they will be used in the order you \fBamlabel\fR them\&. - +\fBAmlabel\fR +appends the new tape to the +\fBtapelist\fR +file so it will be used by +\fBAmanda\fR +before it reuses any other tapes. When you +\fBamlabel\fR +multiple tapes, they will be used in the order you +\fBamlabel\fR +them. .PP -\fBAmlabel\fR will not write the label if the tape contains an active \fBAmanda\fR tape or if the label specified is on an active tape\&. The \fB\-f\fR (force) flag bypasses these verifications\&. - +\fBAmlabel\fR +will not write the label if the tape contains an active +\fBAmanda\fR +tape or if the label specified is on an active tape. The +\fB-f\fR +(force) flag bypasses these verifications. .PP -An optional \fBslot\fR may be specified after the tape label\&. If a tape changer is in use, \fBamlabel\fR will label the tape in the specified slot instead of the currently loaded tape\&. - +An optional +\fBslot\fR +may be specified after the tape label. If a tape changer is in use, +\fBamlabel\fR +will label the tape in the specified slot instead of the currently loaded tape. .PP -See the \fBamanda\fR(8) man page for more details about \fBAmanda\fR\&. - +See the +\fBamanda\fR(8) +man page for more details about +\fBAmanda\fR. .SH "EXAMPLE" - .PP -Write an \fBAmanda\fR label with the string "DMP000" on the tape loaded in the device named in the \fBtapedev\fR option in /usr/local/etc/amanda/daily/amanda\&.conf: +Write an +\fBAmanda\fR +label with the string "DMP000" on the tape loaded in the device named in the +\fBtapedev\fR +option in /usr/local/etc/amanda/daily/amanda.conf: .nf % amlabel daily DMP000 .fi - .PP Label the tape in slot 3 of the currently configured tape changer with the string "DMP003": .nf % amlabel daily DMP003 slot 3 .fi - .SH "MESSAGES" - .TP label \fBlabel\fR doesn't match labelstr \fBstr\fR -Label \fBlabel\fR on the command line does not match the \fBlabelstr\fR regular expression \fBstr\fR from \fBamanda\&.conf\fR\&. - +Label +\fBlabel\fR +on the command line does not match the +\fBlabelstr\fR +regular expression +\fBstr\fR +from +\fBamanda.conf\fR. .TP label \fBlabel\fR already on a tape -Label \fBlabel\fR is already listed as an active \fBAmanda\fR tape\&. - +Label +\fBlabel\fR +is already listed as an active +\fBAmanda\fR +tape. .TP no tpchanger specified in \fBpath\fR , so slot command invalid -The command line has the \fBslot\fR parameter but the \fBamanda\&.conf\fR file in \fBpath\fR does not have a tape changer configured\&. - +The command line has the +\fBslot\fR +parameter but the +\fBamanda.conf\fR +file in +\fBpath\fR +does not have a tape changer configured. .TP reading label \fBlabel\fR, tape is in another amanda configuration -This tape appears to be a valid \fBAmanda\fR tape, but label does not match \fBlabelstr\fR for this configuration so it is probably part of a different \fBAmanda\fR configuration\&. - +This tape appears to be a valid +\fBAmanda\fR +tape, but label does not match +\fBlabelstr\fR +for this configuration so it is probably part of a different +\fBAmanda\fR +configuration. .TP reading label \fBlabel\fR, tape is active -Tape \fBlabel\fR appears to already be part of this \fBAmanda\fR configuration and active, i\&.e\&. has valid data on it\&. - +Tape +\fBlabel\fR +appears to already be part of this +\fBAmanda\fR +configuration and active, i.e. has valid data on it. .TP -no label found, are you sure \fBtape\fR is non\-rewinding? -While checking that the label was written correctly, \fBamlabel\fR got an error that might be caused by mis\-configuring \fBAmanda\fR with a rewinding tape device name instead of a non\-rewinding device name for \fBtape\&.\fR - +no label found, are you sure \fBtape\fR is non-rewinding? +While checking that the label was written correctly, +\fBamlabel\fR +got an error that might be caused by mis-configuring +\fBAmanda\fR +with a rewinding tape device name instead of a non-rewinding device name for +\fBtape.\fR .SH "AUTHOR" - .PP -James da Silva, : Original text - +James da Silva, +: Original text .PP -Stefan G\&. Weichinger, , maintainer of the \fBAmanda\fR\-documentation: XML\-conversion - +Stefan G. Weichinger, +, maintainer of the +\fBAmanda\fR-documentation: XML-conversion .SH "SEE ALSO" - .PP -\fBamanda\fR(8) \fBamdump\fR(8) \fBamflush\fR(8) +\fBamanda\fR(8)\fBamdump\fR(8)\fBamflush\fR(8)