X-Git-Url: https://git.gag.com/?a=blobdiff_plain;f=man%2Famlabel.8;h=02c25278da203c0f83629f618a14e655855bd826;hb=422c17cad7cd7473d9a3b0888ba5a02dd931262c;hp=aca2ce0b45198d4887eaa6c69c4c26f327c6b67b;hpb=cdbbeef9cde260e429854dd313bc0bf7560e1e24;p=debian%2Famanda diff --git a/man/amlabel.8 b/man/amlabel.8 index aca2ce0..02c2527 100644 --- a/man/amlabel.8 +++ b/man/amlabel.8 @@ -1,162 +1,173 @@ -.\"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 "" "" "" +'\" t +.\" Title: amlabel +.\" Author: James da Silva +.\" Generator: DocBook XSL Stylesheets vsnapshot_8273 +.\" Date: 04/10/2009 +.\" Manual: System Administration Commands +.\" Source: Amanda 2.6.1p1 +.\" Language: English +.\" +.TH "AMLABEL" "8" "04/10/2009" "Amanda 2\&.6\&.1p1" "System Administration Commands" +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- .SH "NAME" -amlabel - label an Amanda tape +amlabel \- label an \fIAmanda\fR tape .SH "SYNOPSIS" -.HP 8 -\fBamlabel\fR [-f] \fIconfig\fR \fIlabel\fR [slot \fIslot\fR] [-o \fIconfigoption\fR]* - +.HP \w'\fBamlabel\fR\ 'u +\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 +\fBtapelist\fR(5) 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 -.SH "AUTHOR" -.PP -James da Silva, -: Original text -.PP -Stefan G. Weichinger, -, maintainer of the -\fBAmanda\fR-documentation: XML-conversion +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 "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 +.SH "AUTHORS" +.PP +\fBJames da Silva\fR <\&jds@amanda\&.org\&> +.PP +\fBStefan G\&. Weichinger\fR <\&sgw@amanda\&.org\&>