+'\" 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
.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
.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
\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
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
.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
.PP
log
.RS 4
-for the
-\fIAmanda\fR
-log directory (see
+for the Amanda log directory (see
\fBlogdir\fR
in
\fBamanda\&.conf\fR)
.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
.PP
index
.RS 4
-for an
-\fIAmanda\fR
-index directory (see
+for an Amanda index directory (see
\fBindexdir\fR
in
\fBamanda\&.conf\fR)
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
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
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
.sp
.\}
.RS 4
-.BM yellow
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
\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\&.
\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
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
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
(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\&.
.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
projects / debian / amanda / blobdiff