X-Git-Url: https://git.gag.com/?a=blobdiff_plain;f=man%2Famlabel.8;h=f57e013fa670690c94e3cd225ff1f52a97f3fe10;hb=fb2bd066c2f8b34addafe48d62550e3033a59431;hp=aca2ce0b45198d4887eaa6c69c4c26f327c6b67b;hpb=12179dea039515c06168c0037d048566a3f623de;p=debian%2Famanda diff --git a/man/amlabel.8 b/man/amlabel.8 index aca2ce0..f57e013 100644 --- a/man/amlabel.8 +++ b/man/amlabel.8 @@ -1,162 +1,168 @@ -.\"Generated by db2man.xsl. Don't modify this, modify the source. -.de Sh \" Subsection -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Ip \" List item -.br -.ie \\n(.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -.TH "AMLABEL" 8 "" "" "" +.\" Title: amlabel +.\" Author: +.\" Generator: DocBook XSL Stylesheets v1.73.2 +.\" Date: 08/22/2008 +.\" Manual: +.\" Source: +.\" +.TH "AMLABEL" "8" "08/22/2008" "" "" +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l .SH "NAME" amlabel - label an Amanda tape .SH "SYNOPSIS" .HP 8 -\fBamlabel\fR [-f] \fIconfig\fR \fIlabel\fR [slot \fIslot\fR] [-o \fIconfigoption\fR]* - +\fBamlabel\fR [\-f] \fIconfig\fR \fIlabel\fR [slot\ \fIslot\fR] [\-o\ \fIconfigoption\fR]... .SH "DESCRIPTION" .PP All -\fBAmanda\fR -tapes must be pre-labeled before they are used. -\fBAmanda\fR +\fIAmanda\fR +tapes must be pre\-labeled before they are used\. +\fIAmanda\fR verifies the label in \fBamdump\fR and \fBamflush\fR -before writing to make sure the proper tape is loaded. +before writing to make sure the proper tape is loaded\. .PP \fBAmlabel\fR writes an -\fBAmanda\fR +\fIAmanda\fR label on the tape in the device specified by the -\fBamanda.conf\fR -file in /usr/local/etc/amanda/\fBconfig\fR. -\fBLabel\fR +\fIamanda\.conf\fR +file in /usr/local/etc/amanda/\fIconfig\fR\. +\fILabel\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. +\fIamanda\.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 +\fItapelist\fR file so it will be used by -\fBAmanda\fR -before it reuses any other tapes. When you +\fIAmanda\fR +before it reuses any other tapes\. When you \fBamlabel\fR multiple tapes, they will be used in the order you \fBamlabel\fR -them. +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. +\fIAmanda\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, +\fIslot\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. +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. +\fIAmanda\fR\. .SH "OPTIONS" -.TP -\fB-o\fR \fIconfigoption\fR -See the "\fBCONFIGURATION OVERWRITE\fR" section in -\fBamanda\fR(8). +.PP +\fB\-o\fR \fIconfigoption\fR +.RS 4 +See the "\fBCONFIGURATION OVERRIDE\fR" section in +\fBamanda\fR(8)\. +.RE .SH "EXAMPLE" .PP Write an -\fBAmanda\fR +\fIAmanda\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: +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 +.PP +label \fIlabel\fR doesn\'t match labelstr \fIstr\fR +.RS 4 Label -\fBlabel\fR +\fIlabel\fR on the command line does not match the -\fBlabelstr\fR +\fIlabelstr\fR regular expression -\fBstr\fR +\fIstr\fR from -\fBamanda.conf\fR. -.TP -label \fBlabel\fR already on a tape +\fIamanda\.conf\fR\. +.RE +.PP +label \fIlabel\fR already on a tape +.RS 4 Label -\fBlabel\fR +\fIlabel\fR is already listed as an active -\fBAmanda\fR -tape. -.TP -no tpchanger specified in \fBpath\fR , so slot command invalid +\fIAmanda\fR +tape\. +.RE +.PP +no tpchanger specified in \fIpath\fR , so slot command invalid +.RS 4 The command line has the \fBslot\fR parameter but the -\fBamanda.conf\fR +\fIamanda\.conf\fR file in -\fBpath\fR -does not have a tape changer configured. -.TP -reading label \fBlabel\fR, tape is in another amanda configuration +\fIpath\fR +does not have a tape changer configured\. +.RE +.PP +reading label \fIlabel\fR, tape is in another amanda configuration +.RS 4 This tape appears to be a valid -\fBAmanda\fR +\fIAmanda\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 +\fIAmanda\fR +configuration\. +.RE +.PP +reading label \fIlabel\fR, tape is active +.RS 4 Tape -\fBlabel\fR +\fIlabel\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? +\fIAmanda\fR +configuration and active, i\.e\. has valid data on it\. +.RE +.PP +no label found, are you sure \fItape\fR is non\-rewinding? +.RS 4 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 +got an error that might be caused by mis\-configuring +\fIAmanda\fR +with a rewinding tape device name instead of a non\-rewinding device name for +\fItape\.\fR +.RE .SH "AUTHOR" .PP James da Silva, -: Original text +: Original text .PP -Stefan G. Weichinger, -, maintainer of the -\fBAmanda\fR-documentation: XML-conversion +Stefan G\. Weichinger, +, maintainer of the +\fIAmanda\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), +: http://wiki.zmanda.com