X-Git-Url: https://git.gag.com/?a=blobdiff_plain;f=man%2Famlabel.8;h=d35fa6ea022df35d4edd371b7be916856a87a84b;hb=refs%2Fheads%2Fmaster;hp=aca2ce0b45198d4887eaa6c69c4c26f327c6b67b;hpb=12179dea039515c06168c0037d048566a3f623de;p=debian%2Famanda diff --git a/man/amlabel.8 b/man/amlabel.8 index aca2ce0..d35fa6e 100644 --- a/man/amlabel.8 +++ b/man/amlabel.8 @@ -1,162 +1,174 @@ -.\"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 v1.76.1 +.\" Date: 01/10/2013 +.\" Manual: System Administration Commands +.\" Source: Amanda 3.3.3 +.\" Language: English +.\" +.TH "AMLABEL" "8" "01/10/2013" "Amanda 3\&.3\&.3" "System Administration Commands" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * 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 Amanda 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 [\fB\-\-barcode\ \fR\fB\fIbarcode\fR\fR] [\fB\-\-meta\ \fR\fB\fImeta\-label\fR\fR] [\fB\-\-assign\fR] [\fB\-f\fR] [\fB\-\-version\fR] [\fB\-o\fR\ \fIconfigoption\fR...] \fIconfig\fR [\fIlabel\fR] [slot\ \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 +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 -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. -.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. -.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. -.PP -An optional -\fBslot\fR -may be specified after the tape label. If a tape changer is in use, +\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] +and no +[\fIbarcode\fR] +is given, then \fBamlabel\fR -will label the tape in the specified slot instead of the currently loaded tape. +labels the tape in the current slot of the default changer\&. If a slot is given, it labels the volume in that slot\&. If a barcode is given, it labels the volume with that barcode\&. +\fILabel\fR +may be any string that does not contain whitespace and that matches the +\fBlabelstr\fR +(see +\fBamanda.conf\fR(5))\&. +.PP +If +[\fIlabel\fR] +is not given, an autolabel is generated, see +\fBautolabel\fR +in +\fBamanda.conf\fR(5)\&. .PP -See the -\fBamanda\fR(8) -man page for more details about -\fBAmanda\fR. +If +[\fB\-\-assign\fR] +is given, the barcode and meta\-label are assigned to the label without labeling the volume\&. The label must already be in the tapelist file\&. +.PP +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 +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" -.TP -\fB-o\fR \fIconfigoption\fR -See the "\fBCONFIGURATION OVERWRITE\fR" section in -\fBamanda\fR(8). +.PP +\fB\-\-barcode \fR\fB\fIbarcode\fR\fR +.RS 4 +With +[\-\-assign], assign the barcode to the label\&. Without +[\-\-assign], label the volume with that barcode\&. +.RE +.PP +\fB\-\-meta \fR\fB\fImeta\-label\fR\fR +.RS 4 +Assign the meta label to the label after labeling the volume\&. +.RE +.PP +\fB\-\-assign\fR +.RS 4 +Assign the barcode or meta\-label to the label without labeling the volume\&. The label must already be in the tapelist file\&. +.RE +.PP +\fB\-f\fR +.RS 4 +Force the label operation; see above +.RE +.PP +\fB\-\-version\fR +.RS 4 +Output version information +.RE +.PP +\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 "DMP000" 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 "DMP003": +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, +.PP +Label \*(Aq\fIlabel\fR\*(Aq doesn\*(Aqt match labelstr \*(Aq\fIlabelstr\fR\*(Aq +.RS 4 +The given label does not match the configured labelstr\&. Even with +\fB\-f\fR, this is an error\&. +.RE +.PP +Label \*(Aq\fIlabel\fR\*(Aq 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 \*(Aq\fIlabel\fR\*(Aq, but it is not from configuration \fIconfig\fR\&. +.RS 4 +The label \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 +found on the volume does not match this configuration\*(Aqs +\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 \*(Aq\fIlabel\fR\*(Aq 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