git.gag.com Git - debian/amanda/blob - man/tapelist.5

   1 '\" t
   2 .\"     Title: tapelist
   3 .\"    Author: James da Silva <jds@amanda.org>
   4 .\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
   5 .\"      Date: 07/25/2012
   6 .\"    Manual: File formats and conventions
   7 .\"    Source: Amanda 3.3.2
   8 .\"  Language: English
   9 .\"
  10 .TH "TAPELIST" "5" "07/25/2012" "Amanda 3\&.3\&.2" "File formats and conventions"
  11 .\" -----------------------------------------------------------------
  12 .\" * Define some portability stuff
  13 .\" -----------------------------------------------------------------
  14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  15 .\" http://bugs.debian.org/507673
  16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
  17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  18 .ie \n(.g .ds Aq \(aq
  19 .el       .ds Aq '
  20 .\" -----------------------------------------------------------------
  21 .\" * set default formatting
  22 .\" -----------------------------------------------------------------
  23 .\" disable hyphenation
  24 .nh
  25 .\" disable justification (adjust text to left margin only)
  26 .ad l
  27 .\" -----------------------------------------------------------------
  28 .\" * MAIN CONTENT STARTS HERE *
  29 .\" -----------------------------------------------------------------
  30 .SH "NAME"
  31 tapelist \- The list of Amanda volumes in use
  32 .SH "DESCRIPTION"
  33 .PP
  34 The
  35 \fItapelist\fR
  36 file contains the list of tapes in active use\&. This file is not ordinarily ordinarily edited or examined manually\&. Its format may change, or it may be removed altogether, in future versions of Amanda\&. It contains lines of the form:
  37 .PP
  38 .nf
  39 YYYYMMDD label flags [BARCODE:barcode] [META:meta] [#comment]
  40 .fi
  41 .PP
  42 Where
  43 \fIYYYYMMDD\fR
  44 is the date the tape was written,
  45 \fIlabel\fR
  46 is a label for the tape as written by
  47 \fBamlabel\fR
  48 and
  49 \fIflags\fR
  50 is one of "reuse" or "no\-reuse" and tells Amanda whether the tape may be reused\&. A non\-reusable tape will not be overwritten, even if it is older than
  51 \fBdumpcycle\fR
  52 dumps\&. See the
  53 \fBreuse\fR
  54 options of
  55 \fBamadmin\fR(8)\&. The optional barcode is prefixed with \*(AqBARCODE\*(Aq if the volume have a barcode\&. The optional meta label is prefixed with \*(AqMETA\*(Aq if the volume is on a meta volume\&. The optional comment is prefixed with a \*(Aq#\*(Aq and continues to the end of the line\&. Amanda will maintain this comment until the tape is overwritten\&. Note that comments are not allowed on blank lines\&.
  56 .PP
  57 The file is sorted such that the most\-recently used tape appears on the first line, and the oldest tape appears on the last line\&.
  58 .PP
  59 \fBAmdump\fR
  60 and
  61 \fBamflush\fR
  62 will by default refuse to write to an unlabeled tape, or to a labeled tape that is considered active or marked "no\-reuse"\&. There must be more tapes in active rotation (see the
  63 \fBtapecycle\fR
  64 option) than there are runs in the backup cycle (see the
  65 \fBdumpcycle\fR
  66 option) to prevent overwriting a backup image that would be needed to do a full recovery\&.
  67 .SH "SEE ALSO"
  68 .PP
  69 \fBamanda\fR(8),
  70 \fBamanda.conf\fR(5)
  71 .PP
  72 The Amanda Wiki:
  73 : http://wiki.zmanda.com/
  74 .SH "AUTHORS"
  75 .PP
  76 \fBJames da Silva\fR <\&jds@amanda\&.org\&>
  77 .PP
  78 \fBStefan G\&. Weichinger\fR <\&sgw@amanda\&.org\&>
  79 .PP
  80 \fBDustin J\&. Mitchell\fR <\&dustin@zmanda\&.com\&>
  81 .RS 4
  82 Zmanda, Inc\&. (http://www\&.zmanda\&.com)
  83 .RE