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 vsnapshot_8273 <http://docbook.sf.net/>
   5 .\"      Date: 10/18/2010
   6 .\"    Manual: File formats and conventions
   7 .\"    Source: Amanda 3.2.0
   8 .\"  Language: English
   9 .\"
  10 .TH "TAPELIST" "5" "10/18/2010" "Amanda 3\&.2\&.0" "File formats and conventions"
  11 .\" -----------------------------------------------------------------
  12 .\" * set default formatting
  13 .\" -----------------------------------------------------------------
  14 .\" disable hyphenation
  15 .nh
  16 .\" disable justification (adjust text to left margin only)
  17 .ad l
  18 .\" -----------------------------------------------------------------
  19 .\" * MAIN CONTENT STARTS HERE *
  20 .\" -----------------------------------------------------------------
  21 .SH "NAME"
  22 tapelist \- The list of Amanda volumes in use
  23 .SH "DESCRIPTION"
  24 .PP
  25 The
  26 \fItapelist\fR
  27 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:
  28 .PP
  29 .nf
  30 YYYYMMDD label flags [#comment]
  31 .fi
  32 .PP
  33 Where
  34 \fIYYYYMMDD\fR
  35 is the date the tape was written,
  36 \fIlabel\fR
  37 is a label for the tape as written by
  38 \fBamlabel\fR
  39 and
  40 \fIflags\fR
  41 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
  42 \fBdumpcycle\fR
  43 dumps\&. See the
  44 \fBreuse\fR
  45 options of
  46 \fBamadmin\fR(8)\&. The optional comment is prefixed with a \'#\' 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\&.
  47 .PP
  48 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\&.
  49 .PP
  50 \fBAmdump\fR
  51 and
  52 \fBamflush\fR
  53 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
  54 \fBtapecycle\fR
  55 option) than there are runs in the backup cycle (see the
  56 \fBdumpcycle\fR
  57 option) to prevent overwriting a backup image that would be needed to do a full recovery\&.
  58 .SH "SEE ALSO"
  59 .PP
  60 \fBamanda\fR(8),
  61 \fBamanda.conf\fR(5)
  62 .PP
  63 The Amanda Wiki:
  64 : http://wiki.zmanda.com/
  65 .SH "AUTHORS"
  66 .PP
  67 \fBJames da Silva\fR <\&jds@amanda\&.org\&>
  68 .PP
  69 \fBStefan G\&. Weichinger\fR <\&sgw@amanda\&.org\&>
  70 .PP
  71 \fBDustin J\&. Mitchell\fR <\&dustin@zmanda\&.com\&>
  72 .RS 4
  73 Zmanda, Inc\&. (http://www\&.zmanda\&.com)
  74 .RE