X-Git-Url: https://git.gag.com/?a=blobdiff_plain;f=man%2Famlabel.8;h=c954d08789e52b921ce5b1b4956c7d719370ea2e;hb=b116e9366c7b2ea2c2eb53b0a13df4090e176235;hp=863da6cccc6b74d3980a504259e1fdec6288b9d0;hpb=0de2ad0a86685398621fb8ffa6990c029681bb3a;p=debian%2Famanda diff --git a/man/amlabel.8 b/man/amlabel.8 index 863da6c..c954d08 100644 --- a/man/amlabel.8 +++ b/man/amlabel.8 @@ -1,105 +1,135 @@ -.\"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 "" "" "" -.SH NAME -amlabel \- label an AMANDA tape -.SH "SYNOPSIS" +'\" t +.\" Title: amlabel +.\" Author: James da Silva +.\" Generator: DocBook XSL Stylesheets vsnapshot_8273 +.\" Date: 10/18/2010 +.\" Manual: System Administration Commands +.\" Source: Amanda 3.2.0 +.\" Language: English +.\" +.TH "AMLABEL" "8" "10/18/2010" "Amanda 3\&.2\&.0" "System Administration Commands" +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) .ad l -.hy 0 -.HP 8 -\fBamlabel\fR [\-f] \fIconfig\fR \fIlabel\fR [\fIslot\fR\ \fIslot\fR] -.ad -.hy - +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +amlabel \- label an Amanda tape +.SH "SYNOPSIS" +.HP \w'\fBamlabel\fR\ 'u +\fBamlabel\fR \fIconfig\fR \fIlabel\fR [slot\ \fIslot\fR] [\fB\-f\fR] [\fB\-\-version\fR] [\fB\-o\fR\ \fIconfigoption\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\&. - +This command applies a label to an Amanda volume, erasing the volume in the process\&. +.PP +Amanda uses labels to identify volumes: +\fBamdump\fR(8) +and +\fBamflush\fR(8) +verify the label before writing to make sure the proper volume is loaded, and the recovery programs use the label to ensure they are reading the data they expect\&. +.PP +If no +[\fIslot\fR] +is given, then +\fBamlabel\fR +labels the tape in the current slot of the default changer\&. If a slot is given, it labels the volume in that slot\&. +\fILabel\fR +may be any string that does not contain whitespace and that matches the +\fBlabelstr\fR +(see +\fBamanda.conf\fR(5))\&. .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\&. - +This command also appends the new volume to the +\fBtapelist\fR(5) +file, so that they will be used in the order they are labeled (depending on the taperscan in use \(em see +\fBamanda-taperscan\fR(7))\&. .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\&. - +As a precaution, +\fBamlabel\fR +will not write a label if the volume already contains an active label or if the label specified is on an active tape\&. The +[\-f] +(force) flag bypasses these verifications\&. +.SH "OPTIONS" .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\&. - +\fB\-f\fR +.RS 4 +Force the label operation; see above +.RE .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\&. - +\fB\-\-version\fR +.RS 4 +Output version information +.RE .PP -See the \fBamanda\fR(8) man page for more details about \fBAMANDA\fR\&. - +\fB\-o \fR\fB\fIconfigoption\fR\fR +.RS 4 +See the "CONFIGURATION OVERRIDE" section in +\fBamanda\fR(8)\&. +.RE .SH "EXAMPLE" - .PP -Write an \fBAMANDA\fR label with the string ``\fBDMP000\fR'' on the tape loaded in the device named in the \fBtapedev\fR option in /usr/local/etc/amanda/daily/amanda\&.conf: +Write an Amanda label with the string "DMP000" on the current volume: .nf - % amlabel daily DMP000 .fi - .PP -Label the tape in slot 3 of the currently configured tape changer with the string ``\fBDMP003\fR'': +Label the tape in slot 3 of the changer with the label "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\&. - -.TP -label \fBlabel\fR already on a 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\&. - -.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\&. - -.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\&. - -.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 - -.SH "AUTHOR" - -.PP -James da Silva, : Original text - -.PP -Stefan G\&. Weichinger, , maintainer of the \fBAMANDA\fR\-documentation: XML\-conversion - +.PP +Label \'\fIlabel\fR\' doesn\'t match labelstr \'\fIlabelstr\fR\' +.RS 4 +The given label does not match the configured labelstr\&. Even with +\fB\-f\fR, this is an error\&. +.RE +.PP +Label \'\fIlabel\fR\' already on a volume +.RS 4 +The given label is already on another volume in the tapelist, and Amanda will not write it to this volume unless forced\&. +.RE +.PP +Found label \'\fIlabel\fR\', but it is not from configuration \fIconfig\fR\&. +.RS 4 +The label +\fBamlabel\fR +found on the volume does not match this configuration\'s +\fBlabelstr\fR, so it is probably part of a different Amanda configuration\&. Amanda will not overwrite the label unless it is forced\&. +.RE +.PP +Volume with label \'\fIlabel\fR\' contains data from this configuration\&. +.RS 4 +The label +\fBamlabel\fR +found on the volume still has valid data on it and Amanda will not overwrite it unless forced\&. Note that this does not distinguish between active and inactive volumes\&. +.RE +.PP +.RS 4 +.RE .SH "SEE ALSO" - .PP -\fBamanda\fR(8) \fBamdump\fR(8) \fBamflush\fR(8) - +\fBamanda\fR(8), +\fBamanda.conf\fR(5), +\fBtapelist\fR(5), +\fBamanda-taperscan\fR(7), +\fBamdump\fR(8), +\fBamflush\fR(8) +.PP +The Amanda Wiki: +: http://wiki.zmanda.com/ +.SH "AUTHORS" +.PP +\fBJames da Silva\fR <\&jds@amanda\&.org\&> +.PP +\fBStefan G\&. Weichinger\fR <\&sgw@amanda\&.org\&> +.PP +\fBDustin J\&. Mitchell\fR <\&dustin@zmanda\&.com\&> +.RS 4 +Zmanda, Inc\&. (http://www\&.zmanda\&.com) +.RE