add bug closure to changelog
[debian/amanda] / man / amcheck.8
index be35fcf02bbe08a6ce59b56cbb90c8b190d97bed..717690fdfa5584ee096780012fbfe4d6f4fa5854 100644 (file)
+'\" t
 .\"     Title: amcheck
 .\"    Author: James da Silva <jds@amanda.org>
-.\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/>
-.\"      Date: 01/22/2009
+.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
+.\"      Date: 07/25/2012
 .\"    Manual: System Administration Commands
-.\"    Source: Amanda 2.6.1
+.\"    Source: Amanda 3.3.2
 .\"  Language: English
 .\"
-.TH "AMCHECK" "8" "01/22/2009" "Amanda 2\&.6\&.1" "System Administration Commands"
+.TH "AMCHECK" "8" "07/25/2012" "Amanda 3\&.3\&.2" "System Administration Commands"
 .\" -----------------------------------------------------------------
-.\" * (re)Define some macros
+.\" * Define some portability stuff
 .\" -----------------------------------------------------------------
 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.\" toupper - uppercase a string (locale-aware)
+.\" http://bugs.debian.org/507673
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.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
-.in +2n
-.ll -2n
-.gcolor red
-.di BX
-.\}
-..
-.de EB
-.if t \{\
-.if "\\$2"adjust-for-leading-newline" \{\
-.sp -1
-.\}
-.br
-.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
-.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
-.\}
-..
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
 .\" -----------------------------------------------------------------
 .\" * set default formatting
 .\" -----------------------------------------------------------------
 .\" -----------------------------------------------------------------
 .\" * MAIN CONTENT STARTS HERE *
 .\" -----------------------------------------------------------------
-.SH "Name"
-amcheck \- run \fIAmanda\fR self\-checks
-.SH "Synopsis"
-.fam C
+.SH "NAME"
+amcheck \- run Amanda self\-checks
+.SH "SYNOPSIS"
 .HP \w'\fBamcheck\fR\ 'u
-\fBamcheck\fR [\-am] [\-w] [\-sclt] [\-M\ \fIaddress\fR] \fIconfig\fR [\fIhost\fR\ [\fIdisk\fR...]...] [\-o\ \fIconfigoption\fR]...
-.fam
+\fBamcheck\fR [\-am] [\-w] [\-sclt] [\-M\ \fIaddress\fR] [\-\-client\-verbose] [\fB\-o\fR\ \fIconfigoption\fR...] \fIconfig\fR [\fIhost\fR\ [\fIdisk\fR...]...]
 .SH "DESCRIPTION"
 .PP
 \fBAmcheck\fR
-runs a number of self\-checks on both the
-\fIAmanda\fR
-tape server host and the
-\fIAmanda\fR
-client hosts\&.
+runs a number of self\-checks on both the Amanda tape server host and the Amanda client hosts\&.
 .PP
 On the tape server host,
 \fBamcheck\fR
@@ -195,8 +50,7 @@ You can specify many host/disk expressions, only disks that match an expression
 .PP
 See the
 \fBamanda\fR(8)
-man page for more details about
-\fIAmanda\fR\&.
+man page for more details about Amanda\&.
 .SH "OPTIONS"
 .PP
 \fB\-s\fR
@@ -224,7 +78,9 @@ Run the tape tests on the server host\&.
 .RS 4
 Enables a DESTRUCTIVE check for write\-protection on the tape (which would otherwise cause the subsequent
 \fBamdump\fR
-to fail)\&. If the tape is writable, this check causes all data after the tape label to be erased\&. If the label_new_tapes option is enabled, this check may ERASE any non\-Amanda tape in the drive or changer\&. The check enable the tape tests on the server host and is only made if the tape is otherwise correct\&.
+to fail)\&. If the tape is writable, this check causes all data after the tape label to be erased\&. If the
+\fBautolabel\fR
+option is enabled, this check may ERASE any non\-Amanda tape in the drive or changer\&. The check enable the tape tests on the server host and is only made if the tape is otherwise correct\&.
 .RE
 .PP
 \fB\-m\fR
@@ -258,14 +114,19 @@ value from
 \fB\-m\fR\&.
 .RE
 .PP
+\fB\-\-client\-verbose\fR
+.RS 4
+Print all client messages\&.
+.RE
+.PP
 \fIhost\fR [\fIdisk\fR]*
 .RS 4
 Specify the host and disk on which the command will work\&.
 .RE
 .PP
-\fB\-o\fR \fIconfigoption\fR
+\fB\-o \fR\fB\fIconfigoption\fR\fR
 .RS 4
-See the "\fBCONFIGURATION OVERRIDE\fR" section in
+See the "CONFIGURATION OVERRIDE" section in
 \fBamanda\fR(8)\&.
 .RE
 .PP
@@ -276,21 +137,21 @@ The default is
 In this example, both the tape server and client tests are run\&. The results are displayed on standard output\&.
 .nf
 % amcheck daily
-\fIAmanda\fR Tape Server Host Check
+Amanda Tape Server Host Check
 \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
-/amanda2/amanda/work: 911475 KB disk space available, that\'s plenty\&.
+/amanda2/amanda/work: 911475 KB disk space available, that\*(Aqs plenty\&.
 NOTE: skipping tape\-writable test\&.
 Tape VOL10 label ok\&.
 Server check took 34\&.966 seconds\&.
 
-\fIAmanda\fR Backup Client Hosts Check
+Amanda Backup Client Hosts Check
 \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
 WARNING: northstar: selfcheck request timed out\&.  Host down?
 WARNING: drinkme: selfcheck request timed out\&.  Host down?
 WARNING: scruffy: selfcheck request timed out\&.  Host down?
 Client check: 136 hosts checked in 51\&.945 seconds, 3 problems found\&.
 
-(brought to you by \fIAmanda\fR 2\&.5\&.0) 
+(brought to you by Amanda 2\&.5\&.0) 
 .fi
 .PP
 In this example, if the line
@@ -396,9 +257,7 @@ instead of
 .PP
 ERROR: program dir \fIdirectory\fR: not accessible
 .RS 4
-(error) The directory
-\fIAmanda\fR
-expects to find its auxiliary programs in,
+(error) The directory Amanda expects to find its auxiliary programs in,
 \fIdirectory\fR, is not accessible\&.
 .RE
 .PP
@@ -440,9 +299,7 @@ may be:
 .PP
 log
 .RS 4
-for the
-\fIAmanda\fR
-log directory (see
+for the Amanda log directory (see
 \fBlogdir\fR
 in
 \fBamanda\&.conf\fR)
@@ -458,9 +315,7 @@ in
 .PP
 info
 .RS 4
-for an
-\fIAmanda\fR
-database information directory (see
+for an Amanda database information directory (see
 \fBcurinfo\fR
 in
 \fBamanda\&.conf\fR) or
@@ -468,9 +323,7 @@ in
 .PP
 index
 .RS 4
-for an
-\fIAmanda\fR
-index directory (see
+for an Amanda index directory (see
 \fBindexdir\fR
 in
 \fBamanda\&.conf\fR)
@@ -503,14 +356,14 @@ expected
 to be a directory, but it is something else (e\&.g\&. file)\&.
 .RE
 .PP
-WARNING: info file \FCfile\F[]: does not exist
+WARNING: info file file: does not exist
 .RS 4
 (warning) File
 \fIfile\fR
 does not exist in the text format database\&. Since the parent directories do exist, the file should already have been created\&.
 .RE
 .PP
-ERROR: info file \FCname\F[]: not a file
+ERROR: info file name: not a file
 .RS 4
 (error)
 \fBAmcheck\fR
@@ -519,14 +372,14 @@ expected
 to be a file, but it is something else (e\&.g\&. file)\&.
 .RE
 .PP
-ERROR: info file \FCfile\F[]: not readable
+ERROR: info file file: not readable
 .RS 4
 (error) The text format database file
 \fIfile\fR
 is not readable\&.
 .RE
 .PP
-ERROR: log file \FCfile\F[]: not writable
+ERROR: log file file: not writable
 .RS 4
 (error) Log file
 \fIfile\fR
@@ -559,13 +412,11 @@ WARNING: tapedev is /dev/null, dumps will be thrown away
 parameter in
 \fBamanda\&.conf\fR
 is set to
-\FC/dev/null\F[]
-and
-\fIAmanda\fR
-uses that when debugging to throw all the dump images away\&.
+/dev/null
+and Amanda uses that when debugging to throw all the dump images away\&.
 .RE
 .PP
-WARNING: hold file \FCfile\F[] exists
+WARNING: hold file file exists
 .RS 4
 (info) Hold file
 \fIfile\fR
@@ -617,7 +468,6 @@ option) to allow for unexpected overruns\&.
 .sp
 .\}
 .RS 4
-.BM yellow
 .it 1 an-trap
 .nr an-no-space-flag 1
 .nr an-break-flag 1
@@ -630,11 +480,10 @@ Even though this message is listed as a warning, it causes
 \fBamcheck\fR
 to exit with a non\-zero status\&.
 .sp .5v
-.EM yellow
 .RE
 .RE
 .PP
-Holding disk \fIdisk\fR: \fIN\fR KB disk space available, that\'s plenty\&.
+Holding disk \fIdisk\fR: \fIN\fR KB disk space available, that\*(Aqs plenty\&.
 .RS 4
 (info) There was sufficient free space on holding disk
 \fIdisk\fR\&.
@@ -656,9 +505,7 @@ Holding disk \fIdisk\fR: \fIF\fR KB disk space available, using \fIU\fR KB
 \fIdisk\fR
 has
 \fIF\fR
-KBytes of free space and
-\fIAmanda\fR
-will be using up to
+KBytes of free space and Amanda will be using up to
 \fIU\fR
 Kbytes\&.
 .RE
@@ -691,7 +538,7 @@ ERROR: cannot overwrite active tape \fIlabel\fR\&.
 is still active and cannot be used\&.
 .RE
 .PP
-ERROR: label \fIlabel\fR doesn\'t match labelstr \fIpattern\fR \&.
+ERROR: label \fIlabel\fR doesn\*(Aqt match labelstr \fIpattern\fR \&.
 .RS 4
 (error) The label on tape
 \fIlabel\fR
@@ -745,7 +592,7 @@ or
 were running because a log file or amdump file exists\&. If they are not running, you probably need to run
 \fBamcleanup\fR
 to clear up a previous failure\&. Otherwise, you need to wait until they complete before running
-\fBamcheck\fR\FC\&.\F[]
+\fBamcheck\fR\&.
 .RE
 .PP
 NOTE: skipping tape checks
@@ -806,9 +653,7 @@ ERROR: \fIhost\fR NAK: [NAK parse failed]
 (error)
 \fBAmcheck\fR
 could not parse the negative acknowledgment error from
-\fIhost\fR\&. There might be an
-\fIAmanda\fR
-version mismatch between the host running
+\fIhost\fR\&. There might be an Amanda version mismatch between the host running
 \fBamcheck\fR
 and
 \fIhost\fR\&.
@@ -837,9 +682,12 @@ The exit code of \fBamcheck\fR is one of:
 .SH "SEE ALSO"
 .PP
 \fBamanda\fR(8),
-\fBamdump\fR(8),
-: http://wiki.zmanda.com
-.SH "Authors"
+\fBamanda.conf\fR(5),
+\fBamdump\fR(8)
+.PP
+The Amanda Wiki:
+: http://wiki.zmanda.com/
+.SH "AUTHORS"
 .PP
 \fBJames da Silva\fR <\&jds@amanda\&.org\&>
 .PP