X-Git-Url: https://git.gag.com/?a=blobdiff_plain;f=man%2Famdump.8;h=bd2fcd1c785e36ce4c008a39dbfa4b52dc25288b;hb=b116e9366c7b2ea2c2eb53b0a13df4090e176235;hp=e58c3f72713ae46d767d6e7f4b1d0edc9303773c;hpb=1194fb66aa28d9929c3f2bef3cc6c1c3f40a60a4;p=debian%2Famanda diff --git a/man/amdump.8 b/man/amdump.8 index e58c3f7..bd2fcd1 100644 --- a/man/amdump.8 +++ b/man/amdump.8 @@ -1,79 +1,132 @@ -.\"Generated by db2man.xsl. Don't modify this, modify the source. -.de Sh \" Subsection -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Ip \" List item -.br -.ie \\n(.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -.TH "AMDUMP" 8 "" "" "" -.SH NAME +'\" t +.\" Title: amdump +.\" Author: James da Silva +.\" Generator: DocBook XSL Stylesheets vsnapshot_8273 +.\" Date: 10/18/2010 +.\" Manual: System Administration Commands +.\" Source: Amanda 3.2.0 +.\" Language: English +.\" +.TH "AMDUMP" "8" "10/18/2010" "Amanda 3\&.2\&.0" "System Administration Commands" +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" amdump \- back up all disks in an Amanda configuration .SH "SYNOPSIS" -.ad l -.hy 0 -.HP 7 -\fBamdump\fR \fIconfig\fR [\fIhost\fR\ [\fIdisk\fR...]...] -.ad -.hy - +.HP \w'\fBamdump\fR\ 'u +\fBamdump\fR \fIconfig\fR [\fB\-\-no\-taper\fR] [\fIhost\fR\ [\fIdisk\fR...]...] [\fB\-o\fR\ \fIconfigoption\fR...] .SH "DESCRIPTION" - .PP -\fBAmdump\fR switches to the appropriate \fBAmanda\fR configuration directory, e\&.g\&. /usr/local/etc/amanda/\fBconfig\fR, then attempts to back up every disk specified by the \fBamanda\&.conf\fR file\&. \fBAmdump\fR is normally run by \fBcron\fR\&. - +\fBAmdump\fR +is the main interface to the Amanda backup process\&. It loads the specified configuration and attempts to back up every disk specified by the +\fBdisklist\fR(5)\&. +\fBAmdump\fR +is normally run by +\fBcron\fR\&. .PP -You can specify many host/disk expressions, only disks that match an expression will be dumped\&. All disks are dumped if no expressions are given\&. - +The command optionally takes a set of DLE specifications (see +\fBamanda-match\fR(7)) to narrow the DLEs that will be dumped\&. All disks are dumped if no expressions are given\&. .PP -If the file /usr/local/etc/amanda/\fBconfig\fR/hold exists, \fBamdump\fR 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, \fBamdump\fR checks for the hold file every minute\&. - +If a file named +hold +exists in the configuration directory, +\fBamdump\fR +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, +\fBamdump\fR +checks for the hold file every minute\&. .PP -See the \fBamanda\fR(8) man page for more details about \fBAmanda\fR\&. - +In some cases it is desirable to dump all Amanda clients to holding disk without writing anything to storage media\&. The +\fB\-\-no\-taper\fR +option instructs Amanda to not start the taper, and thus enter degraded mode immediately\&. +.PP +See the +\fBamanda\fR(8) +man page for more details about Amanda\&. +.SH "OPTIONS" +.PP +\fIhost\fR [\fIdisk\fR]* +.RS 4 +Specify the host and disk on which the command will work \-\- see the description of DLE specifications in +\fBamanda-match\fR(7)\&. +.RE +.PP +\fB\-o \fR\fB\fIconfigoption\fR\fR +.RS 4 +See the "CONFIGURATION OVERRIDE" section in +\fBamanda\fR(8)\&. +.RE .SH "EXAMPLE" - .PP -Here is a typical crontab entry\&. It runs \fBamdump\fR every weeknight at 1 a\&.m\&. as user \fBbin\fR: +Here is a typical crontab entry\&. It runs +\fBamdump\fR +every weeknight at 1 a\&.m\&. as user +\fBbin\fR: .nf - 0 1 * * 1\-5 bin /usr/local/sbin/amdump daily .fi - .PP -Please see the \fBcrontab\fR(5) or \fBcrontab\fR(1) manual page for the correct crontab format for your system\&. - +Please see the +\fBcrontab\fR(5) +or +\fBcrontab\fR(1) +manual page for the correct crontab format for your system\&. .SH "MESSAGES" - -.TP +.PP amdump: waiting for hold file to be removed -The "hold" file exists and \fBamdump\fR is waiting for it to be removed before starting backups\&. - -.TP +.RS 4 +The "hold" file exists and +\fBamdump\fR +is waiting for it to be removed before starting backups\&. +.RE +.PP amdump: amdump or amflush is already running, or you must run amcleanup -Amdump detected another \fBamdump\fR or \fBamflush\fR running, or the remains of a previous incomplete \fBamdump\fR or \fBamflush\fR run\&. This run is terminated\&. If the problem is caused by the remains of a previous run, you must execute \fBamcleanup\fR(8) and then rerun \fBamdump\fR\&. - -.SH "AUTHOR" - +.RS 4 +Amdump detected another +\fBamdump\fR +or +\fBamflush\fR +running, or the remains of a previous incomplete +\fBamdump\fR +or +\fBamflush\fR +run\&. This run is terminated\&. If the problem is caused by the remains of a previous run, you must execute +\fBamcleanup\fR(8) +and then rerun +\fBamdump\fR\&. +.RE +.SH "EXIT CODE" + +The exit code of \fBamdump\fR is the ORed value of: +.nf + 0 = success + 1 = error + 2 = a dle give strange message + 4 = a dle failed + 8 = Don\'t know the status of a dle (RESULT_MISSING in the report) + 16 = tape error or no more tape +.fi +.SH "SEE ALSO" .PP -James da Silva, : Original text - +\fBamanda\fR(8), +\fBamcheck\fR(8), +\fBamcleanup\fR(8), +\fBamrestore\fR(8), +\fBamflush\fR(8), +\fBcron\fR(8), +\fBamanda-match\fR(7) .PP -Stefan G\&. Weichinger, , maintainer of the \fBAmanda\fR\-documentation: XML\-conversion - -.SH "SEE ALSO" - +The Amanda Wiki: +: http://wiki.zmanda.com/ +.SH "AUTHORS" .PP -\fBamanda\fR(8), \fBamcheck\fR(8), \fBamcleanup\fR(8), \fBamrestore\fR(8), \fBamflush\fR(8), \fBcron\fR(8) - +\fBJames da Silva\fR <\&jds@amanda\&.org\&> +.PP +\fBStefan G\&. Weichinger\fR <\&sgw@amanda\&.org\&>