X-Git-Url: https://git.gag.com/?a=blobdiff_plain;f=man%2Famlabel.8;h=060cbba40dba2fc19eb1937454c8d50b47084238;hb=f86ca883daf8a5123c8cac43bfd76d514c5b1c82;hp=4a77231ee59836182e9c1d26b82d2ee332a60e5c;hpb=cb8e943df4defb25d0362567131dc31fc0ab238e;p=debian%2Famanda diff --git a/man/amlabel.8 b/man/amlabel.8 index 4a77231..060cbba 100644 --- a/man/amlabel.8 +++ b/man/amlabel.8 @@ -1,156 +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: 11/05/2009 +.\" Manual: System Administration Commands +.\" Source: Amanda 2.6.1p2 +.\" Language: English +.\" +.TH "AMLABEL" "8" "11/05/2009" "Amanda 2\&.6\&.1p2" "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 [\fIslot\fR \fIslot\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" +.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\&>