.\"
.de EX
.if t .ft C
.nf
..
.de EE
.fi
.if t .ft
..
.TH AMDUMP 8
.SH NAME
amdump \- back up all disks in an Amanda configuration
.SH SYNOPSIS
.B amdump
.I config
[
.I host
[
.I disk
]*
]*
.SH DESCRIPTION
.B Amdump
switches to the appropriate Amanda configuration directory,
e.g. @CONFIG_DIR@/\fIconfig\fR,
then attempts to back up every disk specified by the
.I amanda.conf
file.
.B Amdump
is normally run by
.BR cron .
.LP
You can specify many host/disk expression, only disks that
match an expression will be dumped. All disk are dumped if no
expression are given.
.LP
If file @CONFIG_DIR@/\fIconfig\fR/hold exists,
.B amdump
will wait until it is removed before starting the backups.
This allows scheduled backups to be delayed when
circumstances warrant, for example, if the tape device is being
used for some other purpose.
While waiting,
.B amdump
checks for the hold file every minute.
.LP
See the
.IR amanda (8)
man page for more details about Amanda.
.SH EXAMPLE
Here is a typical crontab entry.
It runs
.B amdump
every weeknight at 1 a.m. as user
.BR bin :
.LP
.RS
.EX
.ie '@sbindir@'${exec_prefix}/sbin' \{\
.ie '@exec_prefix@'${prefix}' .ds pr @prefix@/sbin
.el .ds pr @exec_prefix@/sbin\}
.el .ds pr @sbindir@
0 1 * * 1-5 bin \*(pr/amdump @DEFAULT_CONFIG@
.EE
.RE
.LP
Please see the 
.IR crontab (5)
or
.IR crontab (1)
manual page for the correct crontab format for your system.
.SH MESSAGES
.TP
amdump: waiting for hold file to be removed
The "hold" file exists and amdump is waiting for it to be removed
before starting backups.
.TP
amdump: amdump or amflush is already running, or you must run amcleanup
Amdump detected another amdump or amflush running,
or the remains of a previous incomplete amdump or amflush run.
This run is terminated.
If the problem is caused by the remains of a previous run,
you must execute
.IR amcleanup (8)
and then rerun
.IR amdump .
.SH AUTHOR
James da Silva <jds@cs.umd.edu>
.br
University of Maryland, College Park
.SH "SEE ALSO"
amanda(8),
amcheck(8),
amcleanup(8),
amrestore(8),
amflush(8),
cron(8)