git.gag.com Git - debian/amanda/blob - man/amlabel.8

   1 .\"Generated by db2man.xsl. Don't modify this, modify the source.
   2 .de Sh \" Subsection
   3 .br
   4 .if t .Sp
   5 .ne 5
   6 .PP
   7 \fB\\$1\fR
   8 .PP
   9 ..
  10 .de Sp \" Vertical space (when we can't use .PP)
  11 .if t .sp .5v
  12 .if n .sp
  13 ..
  14 .de Ip \" List item
  15 .br
  16 .ie \\n(.$>=3 .ne \\$3
  17 .el .ne 3
  18 .IP "\\$1" \\$2
  19 ..
  20 .TH "AMLABEL" 8 "" "" ""
  21 .SH "NAME"
  22 amlabel - label an Amanda tape
  23 .SH "SYNOPSIS"
  24 .HP 8
  25 \fBamlabel\fR [-f] \fIconfig\fR \fIlabel\fR [\fIslot\fR \fIslot\fR]
  26 .SH "DESCRIPTION"
  27 .PP
  28 All
  29 \fBAmanda\fR
  30 tapes must be pre-labeled before they are used.
  31 \fBAmanda\fR
  32 verifies the label in
  33 \fBamdump\fR
  34 and
  35 \fBamflush\fR
  36 before writing to make sure the proper tape is loaded.
  37 .PP
  38 \fBAmlabel\fR
  39 writes an
  40 \fBAmanda\fR
  41 label on the tape in the device specified by the
  42 \fBamanda.conf\fR
  43 file in /usr/local/etc/amanda/\fBconfig\fR.
  44 \fBLabel\fR
  45 may be any string that does not contain whitespace and that matches the
  46 \fBamanda.conf\fR\fBlabelstr\fR
  47 regular expression option. It is up to the system administrator to define a naming convention.
  48 .PP
  49 \fBAmlabel\fR
  50 appends the new tape to the
  51 \fBtapelist\fR
  52 file so it will be used by
  53 \fBAmanda\fR
  54 before it reuses any other tapes. When you
  55 \fBamlabel\fR
  56 multiple tapes, they will be used in the order you
  57 \fBamlabel\fR
  58 them.
  59 .PP
  60 \fBAmlabel\fR
  61 will not write the label if the tape contains an active
  62 \fBAmanda\fR
  63 tape or if the label specified is on an active tape. The
  64 \fB-f\fR
  65 (force) flag bypasses these verifications.
  66 .PP
  67 An optional
  68 \fBslot\fR
  69 may be specified after the tape label. If a tape changer is in use,
  70 \fBamlabel\fR
  71 will label the tape in the specified slot instead of the currently loaded tape.
  72 .PP
  73 See the
  74 \fBamanda\fR(8)
  75 man page for more details about
  76 \fBAmanda\fR.
  77 .SH "EXAMPLE"
  78 .PP
  79 Write an
  80 \fBAmanda\fR
  81 label with the string "DMP000" on the tape loaded in the device named in the
  82 \fBtapedev\fR
  83 option in /usr/local/etc/amanda/daily/amanda.conf:
  84 .nf
  85
  86 % amlabel daily DMP000
  87 .fi
  88 .PP
  89 Label the tape in slot 3 of the currently configured tape changer with the string "DMP003":
  90 .nf
  91
  92 % amlabel daily DMP003 slot 3
  93 .fi
  94 .SH "MESSAGES"
  95 .TP
  96 label \fBlabel\fR doesn't match labelstr \fBstr\fR
  97 Label
  98 \fBlabel\fR
  99 on the command line does not match the
 100 \fBlabelstr\fR
 101 regular expression
 102 \fBstr\fR
 103 from
 104 \fBamanda.conf\fR.
 105 .TP
 106 label \fBlabel\fR already on a tape
 107 Label
 108 \fBlabel\fR
 109 is already listed as an active
 110 \fBAmanda\fR
 111 tape.
 112 .TP
 113 no tpchanger specified in \fBpath\fR , so slot command invalid
 114 The command line has the
 115 \fBslot\fR
 116 parameter but the
 117 \fBamanda.conf\fR
 118 file in
 119 \fBpath\fR
 120 does not have a tape changer configured.
 121 .TP
 122 reading label \fBlabel\fR, tape is in another amanda configuration
 123 This tape appears to be a valid
 124 \fBAmanda\fR
 125 tape, but label does not match
 126 \fBlabelstr\fR
 127 for this configuration so it is probably part of a different
 128 \fBAmanda\fR
 129 configuration.
 130 .TP
 131 reading label \fBlabel\fR, tape is active
 132 Tape
 133 \fBlabel\fR
 134 appears to already be part of this
 135 \fBAmanda\fR
 136 configuration and active, i.e. has valid data on it.
 137 .TP
 138 no label found, are you sure \fBtape\fR is non-rewinding?
 139 While checking that the label was written correctly,
 140 \fBamlabel\fR
 141 got an error that might be caused by mis-configuring
 142 \fBAmanda\fR
 143 with a rewinding tape device name instead of a non-rewinding device name for
 144 \fBtape.\fR
 145 .SH "AUTHOR"
 146 .PP
 147 James da Silva,
 148 <jds@amanda.org>: Original text
 149 .PP
 150 Stefan G. Weichinger,
 151 <sgw@amanda.org>, maintainer of the
 152 \fBAmanda\fR-documentation: XML-conversion
 153 .SH "SEE ALSO"
 154 .PP
 155 \fBamanda\fR(8)\fBamdump\fR(8)\fBamflush\fR(8)
 156