lintian doesn't like orphan packages with uploaders...

[debian/amanda] / man / amflush.8

diff --git a/man/amflush.8 b/man/amflush.8
index 7a7c73c929b4622ed840f082a7494cf5ed597bf7..08ebb463ea617a322bc2d6d37aad76e305e8b9d3 100644 (file)
--- a/man/amflush.8
+++ b/man/amflush.8
@@ -1,13 +1,22 @@
 '\" t
 .\"     Title: amflush
 .\"    Author: James da Silva <jds@amanda.org>
 '\" t
 .\"     Title: amflush
 .\"    Author: James da Silva <jds@amanda.org>

-.\" Generator: DocBook XSL Stylesheets vsnapshot_8273 <http://docbook.sf.net/>
-.\"      Date: 06/01/2010
+.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
+.\"      Date: 01/10/2013

 .\"    Manual: System Administration Commands
 .\"    Manual: System Administration Commands

-.\"    Source: Amanda 3.1.0
+.\"    Source: Amanda 3.3.3

 .\"  Language: English
 .\"
 .\"  Language: English
 .\"

-.TH "AMFLUSH" "8" "06/01/2010" "Amanda 3\&.1\&.0" "System Administration Commands"
+.TH "AMFLUSH" "8" "01/10/2013" "Amanda 3\&.3\&.3" "System Administration Commands"
+.\" -----------------------------------------------------------------
+.\" * Define some portability stuff
+.\" -----------------------------------------------------------------
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" http://bugs.debian.org/507673
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '

 .\" -----------------------------------------------------------------
 .\" * set default formatting
 .\" -----------------------------------------------------------------
 .\" -----------------------------------------------------------------
 .\" * set default formatting
 .\" -----------------------------------------------------------------


@@ -22,17 +31,20 @@
 amflush \- flush Amanda backup files from holding disk to tape
 .SH "SYNOPSIS"
 .HP \w'\fBamflush\fR\ 'u
 amflush \- flush Amanda backup files from holding disk to tape
 .SH "SYNOPSIS"
 .HP \w'\fBamflush\fR\ 'u

-\fBamflush\fR [\-b] [\-f] [\-s] [\-D\ \fIdatestamp\fR] \fIconfig\fR [\fIhost\fR\ [\fIdisk\fR...]...] [{\fB\-o\fR\ \fIconfigoption\fR}...]
+\fBamflush\fR [\-b] [\-f] [\-\-exact\-match] [\-s] [\-D\ \fIdatestamp\fR] [\fB\-o\fR\ \fIconfigoption\fR...] \fIconfig\fR [\fIhost\fR\ [\fIdisk\fR...]...]

 .SH "DESCRIPTION"
 .PP
 \fBAmflush\fR
 writes Amanda backups from the holding disks to tape, and updates the Amanda info database and
 \fBtapelist\fR(5)
 .SH "DESCRIPTION"
 .PP
 \fBAmflush\fR
 writes Amanda backups from the holding disks to tape, and updates the Amanda info database and
 \fBtapelist\fR(5)

-accordingly\&. Backups may stay in a holding disk when something is wrong with the tape at the time
+accordingly\&. It is similar to amdump, but does not perform any backup operations on Amanda clients\&. Backups may stay in a holding disk when something is wrong with the tape at the time

 \fBamdump\fR
 is run\&. When this happens, the problem must be corrected and
 \fBamflush\fR
 run by hand\&.
 \fBamdump\fR
 is run\&. When this happens, the problem must be corrected and
 \fBamflush\fR
 run by hand\&.

+.PP
+The command optionally takes a set of DLE specifications (see
+\fBamanda-match\fR(7)) to narrow the DLEs for which dumps will be flushed\&. All dumps in holding are flushed if no expressions are given\&.

 .SH "OPTIONS"
 .PP
 \fB\-b\fR
 .SH "OPTIONS"
 .PP
 \fB\-b\fR


@@ -66,16 +78,22 @@ option\&.
 .PP
 \fB\-D datestamp\fR
 .RS 4
 .PP
 \fB\-D datestamp\fR
 .RS 4

-specify a datestamp expression you want to flush, see the "DATESTAMP EXPRESSION" section of
-\fBamanda\fR(8)
-for a description\&.
+specify a datestamp expression you want to flush; see
+\fBamanda-match\fR(7)
+for details on the format of this expression\&.

 \fB\-D 20001225\-7\fR
 will flush all dumps from 25 december 2000 to 27 december 2000\&.
 .RE
 .PP
 \fB\-D 20001225\-7\fR
 will flush all dumps from 25 december 2000 to 27 december 2000\&.
 .RE
 .PP

+\fB\-\-exact\-match\fR
+.RS 4
+The host and disk are parsed as exact values
+.RE
+.PP

 \fIhost\fR [\fIdisk\fR]*
 .RS 4
 \fIhost\fR [\fIdisk\fR]*
 .RS 4

-Specify the host and disk on which the command will work\&.
+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
 .RE
 .PP
 \fB\-o \fR\fB\fIconfigoption\fR\fR


@@ -126,12 +144,12 @@ to tape drive /dev/rmt/0mn\&.
 Expecting tape DMP014 or a new tape\&.  (The last dumps were to tape DMP013)
 Are you sure you want to do this? yes
 Running in background, you can log off now\&.
 Expecting tape DMP014 or a new tape\&.  (The last dumps were to tape DMP013)
 Are you sure you want to do this? yes
 Running in background, you can log off now\&.

-You\'ll get mail when amflush is finished\&.
+You\*(Aqll get mail when amflush is finished\&.

 .fi
 .PP
 .fi
 .PP

-The following example causes amflush to flush everything to tape, then ejects tape, using \'at\' to run the task in the background\&.
+The following example causes amflush to flush everything to tape, then ejects tape, using \*(Aqat\*(Aq to run the task in the background\&.

 .nf
 .nf

-% echo \'amflush \-b \-f MyConfig && mt offline\' | at now
+% echo \*(Aqamflush \-b \-f MyConfig && mt offline\*(Aq | at now

 .fi
 .SH "EXIT CODE"
 
 .fi
 .SH "EXIT CODE"
 


@@ -140,13 +158,14 @@ The exit code of \fBamflush\fR is the ORed value of:
  0  = success
  1  = error
  4  = a dle failed
  0  = success
  1  = error
  4  = a dle failed

- 8  = Don\'t know the status of a dle (RESULT_MISSING in the report)
+ 8  = Don\*(Aqt know the status of a dle (RESULT_MISSING in the report)

  16 = tape error or no more tape
 .fi
 .SH "SEE ALSO"
 .PP
 \fBamanda\fR(8),
  16 = tape error or no more tape
 .fi
 .SH "SEE ALSO"
 .PP
 \fBamanda\fR(8),

-\fBamdump\fR(8)
+\fBamdump\fR(8),
+\fBamanda-match\fR(7)

 .PP
 The Amanda Wiki:
 : http://wiki.zmanda.com/
 .PP
 The Amanda Wiki:
 : http://wiki.zmanda.com/