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: 11/05/2009
   6 .\"    Manual: File formats and conventions
   7 .\"    Source: Amanda 2.6.1p2
   8 .\"  Language: English
   9 .\"
  10 .TH "TAPELIST" "5" "11/05/2009" "Amanda 2\&.6\&.1p2" "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 \fIAmanda\fR 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
  28 \fIAmanda\fR\&. It contains lines of the form:
  29 .PP
  30 .nf
  31 YYYYMMDD label flags [#comment]
  32 .fi
  33 .PP
  34 Where
  35 \fIYYYYMMDD\fR
  36 is the date the tape was written,
  37 \fIlabel\fR
  38 is a label for the tape as written by
  39 \fBamlabel\fR
  40 and
  41 \fIflags\fR
  42 is one of "reuse" or "no\-reuse" and tells
  43 \fIAmanda\fR
  44 whether the tape may be reused\&. A non\-reusable tape will not be overwritten, even if it is older than
  45 \fBdumpcycle\fR
  46 dumps\&. See the
  47 \fBreuse\fR
  48 options of
  49 \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\&.
  50 .PP
  51 \fBAmdump\fR
  52 and
  53 \fBamflush\fR
  54 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
  55 \fBtapecycle\fR
  56 option) than there are runs in the backup cycle (see the
  57 \fBdumpcycle\fR
  58 option) to prevent overwriting a backup image that would be needed to do a full recovery\&.
  59 .SH "AUTHORS"
  60 .PP
  61 \fBJames da Silva\fR <\&jds@amanda\&.org\&>
  62 .PP
  63 \fBStefan G\&. Weichinger\fR <\&sgw@amanda\&.org\&>
  64 .PP
  65 \fBDustin J\&. Mitchell\fR <\&dustin@zmanda\&.com\&>
  66 .RS 4
  67 Zmanda, Inc\&. (http://www\&.zmanda\&.com)
  68 .RE