.\" Title: amanda
-.\" Author:
-.\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/>
-.\" Date: 08/22/2008
-.\" Manual:
-.\" Source:
+.\" Author: James da Silva <jds@amanda.org>
+.\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/>
+.\" Date: 01/22/2009
+.\" Manual: System Administration Commands
+.\" Source: Amanda 2.6.1
+.\" Language: English
.\"
-.TH "AMANDA" "8" "08/22/2008" "" ""
-.\" disable hyphenation
-.nh
-.\" disable justification (adjust text to left margin only)
-.ad l
-.SH "NAME"
-amanda - Advanced Maryland Automatic Network Disk Archiver
-.SH "SYNOPSIS"
-.HP 8
-\fBamadmin\fR \fIconfig\fR \fIcommand\fR [\fIoptions\fR]
-.br
-
-.HP 8
-\fBamcheck\fR [\fIoptions\fR] \fIconfig\fR
-.br
-
-.HP 10
-\fBamcheckdb\fR \fIconfig\fR
-.br
-
-.HP 10
-\fBamcleanup\fR \fIconfig\fR
-.br
-
-.HP 8
-\fBamcrypt\fR
-.br
-
-.HP 5
-\fBamdd\fR [\fIoptions\fR]
-.HP 7
-\fBamdump\fR \fIconfig\fR
-.br
-
-.HP 10
-\fBamaespipe\fR
-.br
-
-.HP 8
-\fBamflush\fR [\-f] \fIconfig\fR
-.br
-
-.HP 10
-\fBamgetconf\fR [\fIconfig\fR] \fIparameter\fR
-.br
-
-.HP 8
-\fBamlabel\fR \fIconfig\fR \fIlabel\fR [\fIslot\fR\ \fIslot\fR]
-.br
-
-.HP 5
-\fBammt\fR [\fIoptions\fR]
-.HP 11
-\fBamoverview\fR \fIconfig\fR [\fIoptions\fR]
-.br
-
-.HP 7
-\fBamplot\fR [\fIoptions\fR] \fIamdump\-files\fR
-.br
-
-.HP 10
-\fBamrecover\fR [\fIconfig\fR] [\fIoptions\fR]
-.br
-
-.HP 9
-\fBamreport\fR [\fIconfig\fR] [\fIoptions\fR]
-.br
-
-.HP 10
-\fBamrestore\fR [\fIoptions\fR] \fItapedevice\fR [\fIhostname\fR\ [\fIdiskname\fR]]
-.br
-
-.HP 12
-\fBamfetchdump\fR [\fIoptions\fR] \fIconfig\fR [\fIhostname\fR\ [\fIdiskname\fR\ [\fIdate\fR\ [level]]]]
-.HP 9
-\fBamrmtape\fR [\fIoptions\fR] \fIconfig\fR \fIlabel\fR
-.br
-
-.HP 9
-\fBamstatus\fR \fIconfig\fR [\fIoptions\fR]
-.br
-
-.HP 7
-\fBamtape\fR \fIconfig\fR \fIcommand\fR [\fIoptions\fR]
-.br
-
-.HP 11
-\fBamtapetype\fR [\fIoptions\fR]
-.HP 6
-\fBamtoc\fR [\fIoptions\fR] \fIlogfile\fR
+.TH "AMANDA" "8" "01/22/2009" "Amanda 2\&.6\&.1" "System Administration Commands"
+.\" -----------------------------------------------------------------
+.\" * (re)Define some macros
+.\" -----------------------------------------------------------------
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" toupper - uppercase a string (locale-aware)
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.de toupper
+.tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ
+\\$*
+.tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz
+..
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" SH-xref - format a cross-reference to an SH section
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.de SH-xref
+.ie n \{\
+.\}
+.toupper \\$*
+.el \{\
+\\$*
+.\}
+..
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" SH - level-one heading that works better for non-TTY output
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.de1 SH
+.\" put an extra blank line of space above the head in non-TTY output
+.if t \{\
+.sp 1
+.\}
+.sp \\n[PD]u
+.nr an-level 1
+.set-an-margin
+.nr an-prevailing-indent \\n[IN]
+.fi
+.in \\n[an-margin]u
+.ti 0
+.HTML-TAG ".NH \\n[an-level]"
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+\." make the size of the head bigger
+.ps +3
+.ft B
+.ne (2v + 1u)
+.ie n \{\
+.\" if n (TTY output), use uppercase
+.toupper \\$*
+.\}
+.el \{\
+.nr an-break-flag 0
+.\" if not n (not TTY), use normal case (not uppercase)
+\\$1
+.in \\n[an-margin]u
+.ti 0
+.\" if not n (not TTY), put a border/line under subheading
+.sp -.6
+\l'\n(.lu'
+.\}
+..
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" SS - level-two heading that works better for non-TTY output
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.de1 SS
+.sp \\n[PD]u
+.nr an-level 1
+.set-an-margin
+.nr an-prevailing-indent \\n[IN]
+.fi
+.in \\n[IN]u
+.ti \\n[SN]u
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.ps \\n[PS-SS]u
+\." make the size of the head bigger
+.ps +2
+.ft B
+.ne (2v + 1u)
+.if \\n[.$] \&\\$*
+..
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" BB/BE - put background/screen (filled box) around block of text
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.de BB
+.if t \{\
+.sp -.5
.br
-
-.HP 12
-\fBamcheckdump\fR [\fIoptions\fR] \fIconfig\fR
+.in +2n
+.ll -2n
+.gcolor red
+.di BX
+.\}
+..
+.de EB
+.if t \{\
+.if "\\$2"adjust-for-leading-newline" \{\
+.sp -1
+.\}
.br
-
-.HP 15
-\fBamserverconfig\fR [\fIoptions\fR] \fIconfig\fR
+.di
+.in
+.ll
+.gcolor
+.nr BW \\n(.lu-\\n(.i
+.nr BH \\n(dn+.5v
+.ne \\n(BHu+.5v
+.ie "\\$2"adjust-for-leading-newline" \{\
+\M[\\$1]\h'1n'\v'+.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[]
+.\}
+.el \{\
+\M[\\$1]\h'1n'\v'-.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[]
+.\}
+.in 0
+.sp -.5v
+.nf
+.BX
+.in
+.sp .5v
+.fi
+.\}
+..
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" BM/EM - put colored marker in margin next to block of text
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.de BM
+.if t \{\
.br
-
-.HP 12
-\fBamaddclient\fR \fIconfig\fR [\fIoptions\fR]
+.ll -2n
+.gcolor red
+.di BX
+.\}
+..
+.de EM
+.if t \{\
.br
-
+.di
+.ll
+.gcolor
+.nr BH \\n(dn
+.ne \\n(BHu
+\M[\\$1]\D'P -.75n 0 0 \\n(BHu -(\\n[.i]u - \\n(INu - .75n) 0 0 -\\n(BHu'\M[]
+.in 0
+.nf
+.BX
+.in
+.fi
+.\}
+..
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "Name"
+amanda \- The Open Source Backup Platform
.SH "DESCRIPTION"
.PP
+This manual page gives an overview of the
\fIAmanda\fR
-is the "Advanced Maryland Automatic Network Disk Archiver"\. This manual page gives an overview of the
-\fIAmanda\fR
-commands and configuration files for quick reference\.
+commands and configuration files for quick reference\&.
+.SS "COMMANDS"
.PP
Here are all the
\fIAmanda\fR
-commands\. Each one has its own manual page\. See them for all the gory details\.
-.PP
-\fBamdump\fR
+commands\&. Each one has its own manual page\&. See them for all the gory details\&.
+.sp
.RS 4
-Take care of automatic
-\fIAmanda\fR
-backups\. This is normally executed by
-\fBcron\fR
-on a computer called the
-\fItape server host\fR
-and requests backups of file systems located on
-\fIbackup\fR
-\fIclients\fR\.
-\fBAmdump\fR
-backs up all disks in the
-\fIdisklist\fR
-file (discussed below) to tape or, if there is a problem, to a special
-\fIholding\fR
-\fIdisk\fR\. After all backups are done,
-\fBamdump\fR
-sends mail reporting failures and successes\.
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamaddclient\fR(8),
.RE
-.PP
-\fBamflush\fR
+.sp
.RS 4
-Flush backups from the holding disk to tape\.
-\fBAmflush\fR
-is used after
-\fBamdump\fR
-has reported it could not write backups to tape for some reason\. When this happens, backups stay in the holding disk\. Run
-\fBamflush\fR
-after the tape problem is corrected to write backups from the holding disk to tape\.
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamadmin\fR(8),
.RE
-.PP
-\fBamcleanup\fR
+.sp
.RS 4
-Clean up after an interrupted
-\fBamdump\fR\. This command is only needed if
-\fBamdump\fR
-was unable to complete for some reason, usually because the tape server host crashed while
-\fBamdump\fR
-was running\.
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamaespipe\fR(8),
.RE
-.PP
-\fBamrecover\fR
+.sp
.RS 4
-Provides an interactive interface to browse the
-\fIAmanda\fR
-index files (backup image catalogues) and select which tapes to recover files from\. It can also run
-\fBamrestore\fR
-and a restore program (e\.g\.
-\fBtar\fR) to actually recover the files\.
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamcheck\fR(8),
.RE
-.PP
-\fBamrestore\fR
+.sp
.RS 4
-Read an
-\fIAmanda\fR
-tape, searching for requested backups\.
-\fBAmrestore\fR
-is suitable for everything from interactive restores of single files to a full restore of all partitions on a failed disk\.
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamcheckdb\fR(8),
.RE
-.PP
-\fBamfetchdump\fR
+.sp
.RS 4
-Performs
-\fIAmanda\fR
-tape restoration, similar to
-\fBamrestore\fR\. Additional capabilities include "hands\-off" searching of multiple tapes, automatic retrieval of specific dump files based on dump logs, and assembly of tape\-spanning split dump files\.
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamcheckdump\fR(8),
.RE
-.PP
-\fBamlabel\fR
+.sp
.RS 4
-Write an
-\fIAmanda\fR
-format label onto a tape\. All
-\fIAmanda\fR
-tapes must be labeled with
-\fBamlabel\fR\.
-\fBAmdump\fR
-and
-\fBamflush\fR
-will not write to an unlabeled tape (see TAPE MANAGEMENT below)\.
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamcleanup\fR(8),
.RE
-.PP
-\fBamcheck\fR
+.sp
.RS 4
-Verify the correct tape is mounted and all file systems on all backup client systems are ready to be backed up\. Often run by
-\fBcron\fR
-before
-\fBamdump\fR
-to generate a mail warning that backups might fail unless corrective action is taken\.
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamcrypt-ossl-asym\fR(8),
.RE
-.PP
-\fBamadmin\fR
+.sp
.RS 4
-Take care of administrative tasks like finding out which tapes are needed to restore a filesystem, forcing hosts to do full backups of selected disks and looking at schedule balance information\.
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamcrypt-ossl\fR(8),
.RE
-.PP
-\fBamtape\fR
+.sp
.RS 4
-Take care of tape changer control operations like loading particular tapes, ejecting tapes and scanning the tape storage slots\.
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamcrypt\fR(8),
.RE
-.PP
-\fBamcheckdump\fR
+.sp
.RS 4
-Check the results of an
-\fIAmanda\fR
-dump\.
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamcryptsimple\fR(8),
.RE
-.PP
-\fBamserverconfig\fR
+.sp
.RS 4
-Program to setup initial
-\fIAmanda\fR
-configuration\.
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamdd\fR(8),
.RE
-.PP
-\fBamaddclient\fR
+.sp
.RS 4
-Program to add client to an existing
-\fIAmanda\fR
-configuration\.
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamdevcheck\fR(8),
.RE
-.PP
-\fBamrmtape\fR
+.sp
.RS 4
-Delete a tape from the
-\fIAmanda\fR
-databases\.
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamdump\fR(8),
.RE
-.PP
-\fBamstatus\fR
+.sp
.RS 4
-Report the status of a running or completed
-\fBamdump\fR\.
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamfetchdump\fR(8),
.RE
-.PP
-\fBamoverview\fR
+.sp
.RS 4
-Display a chart of hosts and file systems backed up every run\.
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamflush\fR(8),
.RE
-.PP
-\fBamplot\fR
+.sp
.RS 4
-Generate utilization plots of
-\fIAmanda\fR
-runs for performance tuning\.
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamgetconf\fR(8),
.RE
-.PP
-\fBamreport\fR
+.sp
.RS 4
-Generate an
-\fIAmanda\fR
-summary E\-mail report\.
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamgpgcrypt\fR(8),
.RE
-.PP
-\fBamtoc\fR
+.sp
.RS 4
-Generate table of content files for
-\fIAmanda\fR
-tapes\.
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamgtar\fR(8),
.RE
-.PP
-\fBamcheckdb\fR
+.sp
.RS 4
-Verify every tape
-\fIAmanda\fR
-knows about is consistent in the database\.
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamlabel\fR(8),
.RE
-.PP
-\fBamgetconf\fR
+.sp
.RS 4
-Look up parameters in the
-\fIAmanda\fR
-configuration file\.
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBammt\fR(8),
.RE
-.PP
-\fBamtapetype\fR
+.sp
.RS 4
-Generate a tapetype definition\.
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamoverview\fR(8),
.RE
-.PP
-\fBamaespipe\fR
+.sp
.RS 4
-Wrapper program from aespipe (data encryption utility)
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamplot\fR(8),
.RE
-.PP
-\fBamcrypt\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamrecover\fR(8),
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamreport\fR(8),
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamrestore\fR(8),
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamrmtape\fR(8),
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamsamba\fR(8),
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamserverconfig\fR(8),
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamservice\fR(8),
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamstar\fR(8),
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamstatus\fR(8),
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamtape\fR(8),
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamtapetype\fR(8),
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamtoc\fR(8),
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamvault\fR(8),
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamzfs-sendrecv\fR(8),
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamzfs-snapshot\fR(8),
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBscript-email\fR(8),
+.RE
+.SS "CONFIGURATION FILES"
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamanda.conf\fR(5),
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamanda-client.conf\fR(5),
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBdisklist\fR(5),
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBtapelist\fR(5),
+.RE
+.SS "DATA FORMATS"
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamanda-archive-format\fR(5),
+.RE
+.SS "CONCEPTS"
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamanda-applications\fR(7),
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamanda-auth\fR(7),
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamanda-changers\fR(7),
+.RE
+.sp
.RS 4
-Reference encryption program for Amanda symmetric data encryption
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamanda-devices\fR(7),
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fBamanda-scripts\fR(7),
.RE
.SH "CONFIGURATION"
.PP
-There are three user\-editable files that control the behavior of
-\fIAmanda\fR\.
+There are four user\-editable files that control the behavior of
+\fIAmanda\fR\&.
.PP
-The first is
-\fBamanda\.conf\fR, the main configuration file\. It contains parameters to customize
-\fIAmanda\fR
-for the site\. Refer to the
-\fBamanda.conf\fR(5), manpage for details on
+The first two are
+\fBamanda.conf\fR(5)
+and
+\fBamanda-client.conf\fR(5), the main configuration files for the server and client, respectively\&. They contain parameters to customize
\fIAmanda\fR
-configuration parameters\.
+for the site\&.
.PP
-Second is the
-\fIdisklist\fR
-file, which lists hosts and disk partitions to back up\.
+Next is the
+\fBdisklist\fR(5)
+file, which lists hosts and disk partitions to back up\&.
.PP
-Third is the
-\fItapelist\fR
-file, which lists tapes that are currently active\. These files are described in more detail in the following sections\.
+Last is the seldom\-edited
+\fBtapelist\fR(5)
+file, which lists tapes that are currently active\&. These files are described in more detail in the following sections\&.
.PP
-All files are stored in individual configuration directories under
-\fI/usr/local/etc/amanda/\fR\. A site will often have more than one configuration\. For example, it might have a
+All files are stored in individual configuration directories, usually under
+\FC/etc/amanda/\F[]\&. A site will often have more than one configuration\&. For example, it might have a
\fInormal\fR
configuration for everyday backups and an
\fIarchive\fR
-configuration for infrequent full archival backups\. The configuration files would be stored under directories
-\fI/usr/local/etc/amanda/normal/\fR
+configuration for infrequent full archival backups\&. The configuration files would be stored under directories
+\FC/etc/amanda/normal/\F[]
and
-\fI/usr/local/etc/amanda/archive/\fR, respectively\. Part of the job of an
+\FC/etc/amanda/archive/\F[], respectively\&. Part of the job of an
\fIAmanda\fR
-administrator is to create, populate and maintain these directories\.
+administrator is to create, populate and maintain these directories\&.
+.SH "LOG FILES"
.PP
All log and database files generated by
\fIAmanda\fR
-go in corresponding directories somewhere\. The exact location is controlled by entries in
-\fBamanda\.conf\fR\. A typical location would be under
-\fI/var/adm/amanda\fR\. For the above example, the files might go in
-\fI/var/adm/amanda/normal/\fR
+go in corresponding directories somewhere\&. The exact location is controlled by entries in
+\fBamanda.conf\fR(5)\&. A typical location would be under
+\FC/var/adm/amanda\F[]\&. For the above example, the files might go in
+\FC/var/adm/amanda/normal/\F[]
and
-\fI/var/adm/amanda/archive/\fR\.
+\FC/var/adm/amanda/archive/\F[]\&.
.PP
As log files are no longer needed (no longer contain relevant information),
\fIAmanda\fR
-cycles them out in various ways, depending on the type of file\.
+cycles them out in various ways, depending on the type of file\&.
.PP
Detailed information about
\fBamdump\fR
-runs are stored in files named
-\fBamdump\.\fR\fINN\fR
+runs are stored in dump logs \-\- files named
+\fBamdump\&.\fR\fINN\fR
where
\fINN\fR
-is a sequence number, with 1 being the most recent file\.
+is a sequence number, with 1 being the most recent file\&.
\fBAmdump\fR
rotates these files each run, keeping roughly the last
\fBtapecycle\fR
-(see below) worth of them\.
+(see below) worth of them\&.
.PP
The file used by
\fBamreport\fR
-to generate the mail summary is named
-\fBlog\.\fR\fIYYYYMMDD\.NN\fR
+to generate the mail summary is the trace log\&. This file constitutes the "catalog" describing the data on the tapes written in a run\&. It is named
+\fBlog\&.\fR\fIYYYYMMDDHHMMSS\&.NN\fR
where
-\fIYYYYMMDD\fR
+\fIYYYYMMDDHHMMSS\fR
is the datestamp of the start of the
\fBamdump\fR
+or
+\fBamflush\fR
run and
\fINN\fR
-is a sequence number started at 0\. At the end of each
+is a sequence number started at 0\&. At the end of each
\fBamdump\fR
run, log files for runs whose tapes have been reused are renamed into a subdirectory of the main log directory (see the
\fBlogdir\fR
parameter below) named
-\fBoldlog\fR\. It is up to the
+\fBoldlog\fR\&. It is up to the
\fIAmanda\fR
-administrator to remove them from this directory when desired\.
+administrator to remove them from this directory when desired\&.
.PP
Index (backup image catalogue) files older than the full dump matching the oldest backup image for a given client and disk are removed by
\fBamdump\fR
-at the end of each run\.
-.SH "DISKLIST FILE"
+at the end of each run\&.
+.SH "Using Samba"
.PP
-The
-\fIdisklist\fR
-file determines which disks will be backed up by
-\fIAmanda\fR\. The file usually contains one line per disk:
+For Samba access,
+\fIAmanda\fR
+needs a file on the Samba server (which may or may not also be the tape server) named
+\FC/etc/amandapass\F[]
+with share names, (clear text) passwords and (optional) domain names, in that order, one per line, whitespace separated\&. By default, the user used to connect to the PC is the same for all PC\'s and is compiled into
+\fIAmanda\fR\&. It may be changed on a host by host basis by listing it first in the password field followed by a percent sign and then the password\&. For instance:
.nf
-\fIhostname diskname\fR [\fIdiskdevice\fR] \fIdumptype\fR [\fIspindle\fR [\fIinterface\fR] ]
+ //some\-pc/home normalpw
+ //another\-pc/disk otheruser%otherpw
.fi
.PP
-All pairs [
-\fIhostname diskname\fR
-] must be unique\.
+With clear text passwords, this file should obviously be tightly protected\&. It only needs to be readable by the
+\fIAmanda\fR\-user on the Samba server\&.
+.SH "HOST & DISK EXPRESSION"
+.PP
+All host and disk arguments to programs are special expressions\&. The command applies to all disks that match your arguments\&. This section describes the matcher\&.
.PP
-Lines starting with # are ignored, as are blank lines\. The fields have the following meanings:
+The matcher matches by word, each word is a glob expression, words are separated by the separator \'\&.\' for host and \'/\' for disk\&. You can anchor the expression at left with a \'^\'\&. You can anchor the expression at right with a \'$\'\&. The matcher is case insensitive for host but is case sensitive for disk\&. A match succeeds if all words in your expression match contiguous words in the host or disk\&.
.PP
-\fIhostname\fR
+dot (\&.)
.RS 4
-The name of the host to be backed up\. If
-\fBdiskdevice\fR
-refers to a PC share, this is the host
-\fIAmanda\fR
-will run the Samba
-\fBsmbclient\fR
-program on to back up the share\.
+word separator for a host
.RE
.PP
-\fIdiskname\fR
-.RS 4
-The name of the disk (a label)\. In most case, you set your
-\fBdiskname\fR
-to the
-\fBdiskdevice\fR
-and you don\'t set the
-\fBdiskdevice\.\fR
-If you want multiple entries with the same
-\fBdiskdevice\fR, you must set a different
-\fBdiskname\fR
-for each entry\. It\'s the
-\fBdiskname\fR
-that you use on the commandline for any
-\fIAmanda\fR
-command\. Look at the example/disklist file for example\.
+/
+.RS 4
+word separator for a disk
.RE
.PP
-\fIdiskdevice\fR
+^
.RS 4
-Default: same as diskname\. The name of the disk device to be backed up\. It may be a full device name, a device name without the
-\fI/dev/\fR
-prefix, e\.g\.
-\fIsd0a\fR, or a mount point such as
-\fI/usr\fR\.
-.sp
-It may also refer to a PC share by starting the name with two (forward) slashes, e\.g\.
-\fI//some\-pc/home\fR\. In this case, the
-\fBprogram\fR
-option in the associated
-\fBdumptype\fR
-must be entered as
-\fBGNUTAR\fR\. It is the combination of the double slash disk name and
-\fBprogram GNUTAR\fR
-in the
-\fBdumptype\fR
-that triggers the use of Samba\.
+anchor at left
.RE
.PP
-\fIdumptype\fR
+$
.RS 4
-Refers to a
-\fBdumptype\fR
-defined in the
-\fBamanda\.conf\fR
-file\.
-\fIDumptype\fRs specify backup related parameters, such as whether to compress the backups, whether to record backup results in
-\fI/etc/dumpdates\fR, the disk\'s relative priority, etc\.
+anchor at right
.RE
.PP
-\fIspindle\fR
+?
.RS 4
-Default:
-\fB\-1\fR\. A number used to balance backup load on a host\.
-\fIAmanda\fR
-will not run multiple backups at the same time on the same spindle, unless the spindle number is \-1, which means there is no spindle restriction\.
+match exactly one character except the separator
.RE
.PP
-\fIinterface\fR
+*
.RS 4
-Default:
-\fIlocal\fR\. The name of a network interface definition in the
-\fBamanda\.conf\fR
-file, used to balance network load\.
+match zero or more characters except the separator
.RE
.PP
-Instead of naming a
-\fBdumptype\fR, it is possible to define one in\-line, enclosing
-\fBdumptype\fR
-options within curly braces, one per line, just like a
-\fBdumptype\fR
-definition in
-\fBamanda\.conf\fR\. Since pre\-existing
-\fBdumptype\fRs are valid option names, this syntax may be used to customize
-\fBdumptype\fRs for particular disks\.
-.PP
-A line break
-\fBmust\fR
-follow the left curly bracket\.
-.PP
-For instance, if a
-\fBdumptype\fR
-named
-\fInormal\fR
-is used for most disks, but use of the holding disk needs to be disabled for the file system that holds it, this would work instead of defining a new dumptype:
-.nf
-\fIhostname diskname\fR [ \fIdiskdevice\fR ] {
- normal
- holdingdisk never
-} [ \fIspindle\fR [ \fIinterface\fR ] ]
-.fi
-.SH "TAPE MANAGEMENT"
-.PP
-The
-\fItapelist\fR
-file contains the list of tapes in active use\. This file is maintained entirely by
-\fIAmanda\fR
-and should not be created or edited during normal operation\. It contains lines of the form:
-.PP
-.nf
-YYYYMMDD label flags
-.fi
-.PP
-Where
-\fIYYYYMMDD\fR
-is the date the tape was written,
-\fIlabel\fR
-is a label for the tape as written by
-\fBamlabel\fR
-and
-\fIflags\fR
-tell
-\fIAmanda\fR
-whether the tape may be reused, etc (see the
-\fBreuse\fR
-options of
-\fBamadmin\fR)\.
-.PP
-\fBAmdump\fR
-and
-\fBamflush\fR
-will refuse to write to an unlabeled tape, or to a labeled tape that is considered active\. There must be more tapes in active rotation (see the
-\fBtapecycle\fR
-option) than there are runs in the backup cycle (see the
-\fBdumpcycle\fR
-option) to prevent overwriting a backup image that would be needed to do a full recovery\.
-.SH "OUTPUT DRIVERS"
-.PP
-The normal value for the
-\fBtapedev\fR
-parameter, or for what a tape changer returns, is a full path name to a non\-rewinding tape device, such as
-\fI/dev/nst0\fR
-or
-\fI/dev/rmt/0mn\fR
-or
-\fI/dev/nst0\.1\fR
-or whatever conventions the operating system uses\.
-\fIAmanda\fR
-provides additional application level drivers that support non\-traditional tape\-simulations or features\. To access a specific output driver, set
-\fBtapedev\fR
-(or configure your changer to return) a string of the form
-\fIdriver\fR:\fIdriver\-info\fR
-where
-\fIdriver\fR
-is one of the supported drivers and
-\fIdriver\-info\fR
-is optional additional information needed by the driver\.
+**
+.RS 4
+match zero or more characters including the separator
+.RE
.PP
-The supported drivers are:
+Some examples:
.PP
-\fItape\fR
+hosta
.RS 4
-This is the default driver\. The
-\fIdriver\-info\fR
-is the tape device name\. Entering
-.sp
-.nf
-tapedev /dev/rmt/0mn
-.fi
-is really a short hand for
-.sp
-.nf
-tapedev tape:/dev/rmt/0mn
-.fi
+Will match
+\FChosta\F[],
+\FCfoo\&.hosta\&.org\F[], and
+\FChoSTA\&.dOMAIna\&.ORG\F[]
+but not
+\FChostb\F[]\&.
.RE
.PP
-\fInull\fR
+host
.RS 4
-This driver throws away anything written to it and returns EOF for any reads except a special case is made for reading a label, in which case a "fake" value is returned that
-\fIAmanda\fR
-checks for and allows through regardless of what you have set in
-\fBlabelstr\fR\. The
-\fIdriver\-info\fR
-field is not used and may be left blank:
-.sp
-.sp
-.nf
-tapedev null:
-.fi
-.sp
-The
-\fIlength\fR
-value from the associated
-\fBtapetype\fR
-is used to limit the amount of data written\. When the limit is reached, the driver will simulate end of tape\.
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-Note
-This driver should only be used for debugging and testing, and probably only with the
-\fBrecord\fR
-option set to
-\fIno\fR\.
+Will match
+\FChost\F[]
+but not
+\FChosta\F[]\&.
.RE
.PP
-\fIrait\fR
+host?
.RS 4
-\fIR\fRedundant
-\fIA\fRrray of
-\fII\fRnexpensive (?)
-\fIT\fRapes\. Reads and writes tapes mounted on multiple drives by spreading the data across N\-1 drives and using the last drive for a checksum\. See docs/RAIT for more information\.
-.sp
-The
-\fIdriver\-info\fR
-field describes the devices to use\. Curly braces indicate multiple replacements in the string\. For instance:
-.sp
-.sp
-.nf
-tapedev rait:/dev/rmt/tps0d{4,5,6}n
-.fi
-.sp
-would use the following devices:
-.sp
-\fI/dev/rmt/tps0d4n\fR
-\fI/dev/rmt/tps0d5n\fR
-\fI/dev/rmt/tps0d6n\fR
+Will match
+\FChosta\F[]
+and
+\FChostb\F[], but not
+\FChost\F[]\&.
.RE
.PP
-\fIfile\fR
-.RS 4
-This driver emulates a tape device with a set of files in a directory\. The
-\fIdriver\-info\fR
-field must be the name of an existing directory\. The driver will test for a subdirectory of that named
-\fIdata\fR
-and return
-\fBoffline\fR
-until it is present\. When present, the driver uses two files in the
-\fIdata\fR
-subdirectory for each tape file\. One contains the actual data\. The other contains record length information\.
-.sp
-The driver uses a file named
-\fIstatus\fR
-in the
-\fBfile\fR
-device directory to hold driver status information, such as tape position\. If not present, the driver will create it as though the device is rewound\.
-.sp
-The
-\fIlength\fR
-value from the associated
-\fBtapetype\fR
-is used to limit the amount of data written\. When the limit is reached, the driver will simulate end of tape\.
-.sp
-One way to use this driver with a real device such as a CD\-writer is to create a directory for the
-\fBfile\fR
-device and one or more other directories for the actual data\. Create a symlink named
-\fIdata\fR
-in the
-\fBfile\fR
-directory to one of the data directories\. Set the
-\fBtapetype\fR
-length to whatever the medium will hold\.
-.sp
-When
-\fIAmanda\fR
-fills the
-\fBfile\fR
-device, remove the symlink and (optionally) create a new symlink to another data area\. Use a CD writer software package to burn the image from the first data area\.
-.sp
-To read the CD, mount it and create the
-\fIdata\fR
-symlink in the
-\fBfile\fR
-device directory\.
+ho*na
+.RS 4
+Will match
+\FChoina\F[]
+but not
+\FCho\&.aina\&.org\F[]\&.
.RE
-.SH "AUTHORIZATION"
-.PP
-\fIAmanda\fR
-processes on the tape server host run as the
-\fBdumpuser\fR
-user listed in
-\fBamanda\.conf\fR\. When they connect to a backup client, they do so with an
-\fIAmanda\fR\-specific protocol\. They do not, for instance, use
-\fBrsh\fR
-or
-\fBssh\fR
-directly\.
.PP
-On the client side, the
-\fBamandad\fR
-daemon validates the connection using one of several methods, depending on how it was compiled and on options it is passed:
+ho**na
+.RS 4
+Will match
+\FChoina\F[]
+and
+\FCho\&.aina\&.org\F[]\&.
+.RE
.PP
-\.rhosts
+^hosta
.RS 4
-Even though
-\fIAmanda\fR
-does not use
-\fBrsh\fR, it can use
-\fB\.rhosts\fR\-style authentication and a
-\fB\.rhosts\fR
-file\.
+Will match
+\FChosta\F[]
+but not
+\FCfoo\&.hosta\&.org\F[]\&.
.RE
.PP
-\.amandahosts
+sda*
.RS 4
-This is essentially the same as
-\fB\.rhosts\fR
-authentication except a different file, with almost the same format, is used\. This is the default mechanism built into
-\fIAmanda\fR\.
-.sp
-The format of the
-\fI\.amandahosts\fR
-file is:
-.sp
-\fIhostname\fR
-[
-\fIusername\fR
-[
-\fIservice\fR
-]*]
-.sp
-If
-\fIusername\fR
-is ommitted, it defaults to the user running
-\fBamandad\fR, i\.e\. the user listed in the
-\fBinetd\fR
-or
-\fBxinetd\fR
-configuration file\.
-.sp
-The
-\fIservice\fR
-is a list of the service the client is authorized to execute:
-\fBamdump\fR,
-\fBnoop\fR,
-\fBselfcheck\fR,
-\fBsendsize\fR,
-\fBsendbackup\fR,
-\fBamindexd\fR,
-\fBamidxtaped\fR\.
-\fBamdump\fR
-is a shortcut for "noop selfcheck sendsize sendbackup"
+Will match
+\FC/dev/sda1\F[]
+and
+\FC/dev/sda12\F[]\&.
.RE
.PP
-Kerberos
+/opt
.RS 4
-\fIAmanda\fR
-may use the Kerberos authentication system\. Further information is in the
-\fBdocs/KERBEROS\fR
-file that comes with an
-\fIAmanda\fR
-distribution\.
-.sp
-For Samba access,
-\fIAmanda\fR
-needs a file on the Samba server (which may or may not also be the tape server) named
-\fI/etc/amandapass\fR
-with share names, (clear text) passwords and (optional) domain names, in that order, one per line, whitespace separated\. By default, the user used to connect to the PC is the same for all PC\'s and is compiled into
-\fIAmanda\fR\. It may be changed on a host by host basis by listing it first in the password field followed by a percent sign and then the password\. For instance:
-.nf
- //some\-pc/home normalpw
- //another\-pc/disk otheruser%otherpw
-.fi
-With clear text passwords, this file should obviously be tightly protected\. It only needs to be readable by the
-\fIAmanda\fR\-user on the Samba server\.
-.sp
-You can find further information in the
-\fBdocs/SAMBA\fR
-file that comes with an
-\fIAmanda\fR
-distribution\.
+Will match the disk
+\FCopt\F[]
+but not the host
+\FCopt\F[]\&.
.RE
-.SH "HOST & DISK EXPRESSION"
.PP
-All host and disk arguments to programs are special expressions\. The command applies to all disks that match your arguments\. This section describes the matcher\.
+(note dots:) \&.opt\&.
+.RS 4
+Will match the host
+\FCopt\F[]
+but not the disk
+\FCopt\F[]\&.
+.RE
.PP
-The matcher matches by word, each word is a glob expression, words are separated by the separator \'\.\' for host and \'/\' for disk\. You can anchor the expression at left with a \'^\'\. You can anchor the expression at right with a \'$\'\. The matcher is case insensitive for host but is case sensitive for disk\. A match succeeds if all words in your expression match contiguous words in the host or disk\.
-.TS
-tab(:);
-l l
-l l
-l l
-l l
-l l
-l l
-l l.
-T{
-\.
-T}:T{
-word separator for a host
-T}
-T{
/
-T}:T{
-word separator for a disk
-T}
-T{
-^
-T}:T{
-anchor at left
-T}
-T{
-$
-T}:T{
-anchor at right
-T}
-T{
-?
-T}:T{
-match exactly one character except the separator
-T}
-T{
-*
-T}:T{
-match zero or more characters except the separator
-T}
-T{
-**
-T}:T{
-match zero or more characters including the separator
-T}
-.TE
+.RS 4
+Will match the disk
+\FC/\F[]
+but no other disk\&.
+.RE
.PP
-Some examples:
-.TS
-tab(:);
-l l l
-l l l
-l l l
-l l l
-l l l
-l l l
-l l l
-l l l
-l l l
-l l l
-l l l
-l l l
-l l l
-l l l
-l l l
-l l l
-l l l
-l l l
-l l l.
-T{
-EXPRESSION
-T}:T{
-WILL MATCH
-T}:T{
-WILL NOT MATCH
-T}
-T{
-hosta
-T}:T{
-hosta
-T}:T{
-hostb
-T}
-T{
-\
-T}:T{
-hoSTA\.dOMAIna\.ORG
-T}:T{
-\
-T}
-T{
-\
-T}:T{
-foo\.hosta\.org
-T}:T{
-\
-T}
-T{
-host
-T}:T{
-host
-T}:T{
-hosta
-T}
-T{
-host?
-T}:T{
-hosta
-T}:T{
-host
-T}
-T{
-\
-T}:T{
-hostb
-T}:T{
-\
-T}
-T{
-ho*na
-T}:T{
-hoina
-T}:T{
-ho\.aina\.org
-T}
-T{
-ho**na
-T}:T{
-hoina
-T}:T{
-\
-T}
-T{
-\
-T}:T{
-ho\.aina\.org
-T}:T{
-\
-T}
-T{
-^hosta
-T}:T{
-hosta
-T}:T{
-foo\.hosta\.org
-T}
-T{
-sda*
-T}:T{
-/dev/sda1
-T}:T{
-\
-T}
-T{
-\
-T}:T{
-/dev/sda12
-T}:T{
-\
-T}
-T{
-/opt
-T}:T{
-opt (disk)
-T}:T{
-opt (host)
-T}
-T{
-\.opt\.
-T}:T{
-opt (host)
-T}:T{
-opt (disk)
-T}
-T{
-/
-T}:T{
-/
-T}:T{
-any other disk
-T}
-T{
-/usr
-T}:T{
/usr
-T}:T{
-\
-T}
-T{
-\
-T}:T{
-/usr/opt
-T}:T{
-\
-T}
-T{
+.RS 4
+Will match the disks
+\FC/usr\F[]
+and
+\FC/usr/local\F[]\&.
+.RE
+.PP
/usr$
-T}:T{
-/usr
-T}:T{
-/usr/opt
-T}
-.TE
-.sp
+.RS 4
+Will match the disks
+\FC/usr\F[]
+but not
+\FC/usr/local\F[]\&.
+.RE
.SH "DATESTAMP EXPRESSION"
.PP
A
\fIdatestamp\fR
-expression is a range expression where we only match the prefix\. Leading ^ is removed\. Trailing $ forces an exact match\.
-.TS
-allbox tab(:);
-l l
-l l
-l l
-l l
-l l
-l l
-l l.
-T{
+expression is a range expression where we only match the prefix\&. Leading ^ is removed\&. Trailing $ forces an exact match\&.
+.PP
20001212\-14
-T}:T{
+.RS 4
match all dates beginning with 20001212, 20001213 or 20001214
-T}
-T{
+.RE
+.PP
20001212\-4
-T}:T{
+.RS 4
same as previous
-T}
-T{
+.RE
+.PP
20001212\-24
-T}:T{
+.RS 4
match all dates between 20001212 and 20001224
-T}
-T{
+.RE
+.PP
2000121
-T}:T{
+.RS 4
match all dates that start with 2000121 (20001210\-20001219)
-T}
-T{
+.RE
+.PP
2
-T}:T{
+.RS 4
match all dates that start with 2 (20000101\-29991231)
-T}
-T{
+.RE
+.PP
2000\-10
-T}:T{
+.RS 4
match all dates between 20000101\-20101231
-T}
-T{
+.RE
+.PP
200010$
-T}:T{
+.RS 4
match only 200010
-T}
-.TE
-.PP
+.RE
.SH "DUMP SPECIFICATIONS"
.PP
-A dump specification selects one or more dumps\. It has the form
-\fI[host][:disk][@datestamp]\fR, where each component is a pattern as described above\. If a component is missing, it is treated as a wildcard\. The characters \':\', \'@\', and \'\e\' may be escaped within any component by preceding them with a \'\e\'\.
+A dump specification selects one or more dumps\&. It has the form
+\fI[host][:disk][@datestamp]\fR, where each component is a pattern as described above\&. If a component is missing, it is treated as a wildcard\&. The characters \':\', \'@\', and \'\e\' may be escaped within any component by preceding them with a \'\e\'\&.
.PP
Some examples:
-.TS
-tab(:);
-l l
-l l
-l l
-l l
-l l
-l l.
-T{
-DUMPSPEC
-T}:T{
-DESCRIPTION
-T}
-T{
+.PP
client17
-T}:T{
+.RS 4
all dumps of client17
-T}
-T{
+.RE
+.PP
@20080615
-T}:T{
+.RS 4
All dumps on with datestamps matching 20080615
-T}
-T{
+.RE
+.PP
webserver:/var/www
-T}:T{
+.RS 4
All dumps of /var/www on host webserver
-T}
-T{
+.RE
+.PP
webserver:/var/www@200806150317
-T}:T{
+.RS 4
The dump of webserver with datestamp 200806150317
-T}
-T{
+.RE
+.PP
:/var/www
-T}:T{
+.RS 4
All dumps of /var/www on any host
-T}
-.TE
-.sp
+.RE
.SH "CONFIGURATION OVERRIDE"
.PP
Most commands allow the override of specific configuration options on the command line, using the
\-o
-option\. This option has the form
-\-o\fIname\fR=\fIvalue\fR\. An optional space is allowed after the
-\-o\. Each configuration option should be specified in a separate command\-line option\.
+option\&. This option has the form
+\-o\fIname\fR=\fIvalue\fR\&. An optional space is allowed after the
+\-o\&. Each configuration option should be specified in a separate command\-line option\&.
.PP
For global options,
\fIname\fR
-is simply the name of the option, e\.g\.,
+is simply the name of the option, e\&.g\&.,
.sp
.nf
amdump \-oruntapes=2
\fISECTION\fR
is one of TAPETYPE, DUMPTYPE, HOLDINGDISK, or INTERFACE, and
\fIsection_name\fR
-is the name of the tapetype, dumptype, holdingdisk, or interface\. Examples:
+is the name of the tapetype, dumptype, holdingdisk, or interface\&. Examples:
.sp
.nf
amdump \-o TAPETYPE:HP\-DAT:length=2000m
amdump \-o INTERFACE:local:use="2000 kbps"
.fi
.PP
-Note that configuration overrides are not effective for tape changers, which supply a tapedev based on their own configuration\. In order to override
+When overriding device properties, one must carefully quote the command line to simulate the syntax of real configuration files\&. The following example should serve as a guide:
+.sp
+.nf
+amdump \-o \'device\-property="PROPERTY_MAX_VOLUME_USAGE" "100000"\'
+.fi
+.PP
+Note that configuration overrides are not effective for tape changers, which supply a tapedev based on their own configuration\&. In order to override
\fItapedev\fR, you must also disable any changer:
.sp
.nf
amdump \-otapedev=/dev/nst1 \-otpchanger=\'\'
.fi
-.SH "AUTHOR"
-.PP
-James da Silva,
-<jds@amanda\.org>
-: Original text
+.SH "Authors"
.PP
-Stefan G\. Weichinger,
-<sgw@amanda\.org>, maintainer of the
-\fIAmanda\fR\-documentation: XML\-conversion, major update
-.SH "SEE ALSO"
+\fBJames da Silva\fR <\&jds@amanda\&.org\&>
.PP
-
-\fBamadmin\fR(8),
-\fBamanda.conf\fR(5),
-\fBamanda-client.conf\fR(5),
-\fBamcheck\fR(8),
-\fBamcheckdb\fR(8),
-\fBamcleanup\fR(8),
-\fBamdd\fR(8),
-\fBamdump\fR(8),
-\fBamfetchdump\fR(8)
-\fBamflush\fR(8),
-\fBamgetconf\fR(8),
-\fBamlabel\fR(8),
-\fBammt\fR(8),
-\fBamoverview\fR(8),
-\fBamplot\fR(8),
-\fBamrecover\fR(8),
-\fBamreport\fR(8),
-\fBamrestore\fR(8),
-\fBamrmtape\fR(8),
-\fBamstatus\fR(8),
-\fBamtape\fR(8),
-\fBamtapetype\fR(8),
-\fBamtoc\fR(8),
-\fBamcheckdump\fR(8),
-\fBamserverconfig\fR(8),
-\fBamaddclient\fR(8),
-: http://wiki.zmanda.com
+\fBStefan G\&. Weichinger\fR <\&sgw@amanda\&.org\&>
projects / debian / amanda / blobdiff