-.\"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 "AMCHECK" 8 "" "" ""
+.\" Title: amcheck
+.\" Author:
+.\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/>
+.\" Date: 08/22/2008
+.\" Manual:
+.\" Source:
+.\"
+.TH "AMCHECK" "8" "08/22/2008" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
.SH "NAME"
amcheck - run Amanda self-checks
.SH "SYNOPSIS"
.HP 8
-\fBamcheck\fR [-mwsclt] [-Maddress] \fIconfig\fR [\fIhost\fR [\fIdisk\fR...]...]
+\fBamcheck\fR [\-am] [\-w] [\-sclt] [\-M\ \fIaddress\fR] \fIconfig\fR [\fIhost\fR\ [\fIdisk\fR...]...] [\-o\ \fIconfigoption\fR]...
.SH "DESCRIPTION"
.PP
\fBAmcheck\fR
-runs a number of self-checks on both the
-\fBAmanda\fR
+runs a number of self\-checks on both the
+\fIAmanda\fR
tape server host and the
-\fBAmanda\fR
-client hosts.
+\fIAmanda\fR
+client hosts\.
.PP
On the tape server host,
\fBamcheck\fR
can go through the same tape checking used at the start of the nightly
\fBamdump\fR
-run to verify the correct tape for the next run is mounted.
+run to verify the correct tape for the next run is mounted\.
.PP
\fBAmcheck\fR
-can also do a self-check on all client hosts to make sure each host is running and that permissions on filesystems to be backed up are correct.
+can also do a self\-check on all client hosts to make sure each host is running and that permissions on filesystems to be backed up are correct\.
.PP
-You can specify many host/disk expressions, only disks that match an expression will be checked. All disks are checked if no expressions are given.
+You can specify many host/disk expressions, only disks that match an expression will be checked\. All disks are checked if no expressions are given\.
.PP
See the
\fBamanda\fR(8)
man page for more details about
-\fBAmanda\fR.
+\fIAmanda\fR\.
.SH "OPTIONS"
-.TP
-\fB-s\fR
+.PP
+\fB\-s\fR
+.RS 4
Run the tape server local and tape checks (same as
-\fB-lt\fR).
-.TP
-\fB-c\fR
-Run the client host checks.
-.TP
-\fB-l\fR
-Run the local tests (e.g. permissions) on the server host.
-.TP
-\fB-t\fR
-Run the tape tests on the server host.
-.TP
-\fB-w\fR
-Enables a DESTRUCTIVE check for write-protection on the tape (which would otherwise cause the subsequent
+\fB\-lt\fR)\.
+.RE
+.PP
+\fB\-c\fR
+.RS 4
+Run the client host checks\. Multiple specific clients can be checked by specifying the client name\.
+.RE
+.PP
+\fB\-l\fR
+.RS 4
+Run the local tests (e\.g\. permissions) on the server host\.
+.RE
+.PP
+\fB\-t\fR
+.RS 4
+Run the tape tests on the server host\.
+.RE
+.PP
+\fB\-w\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 implies
-\fB-t\fR
-and is only made if the tape is otherwise correct.
-.TP
-\fB-m\fR
-Nothing is printed, but mail is sent if any errors are detected. The mail goes to the
+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\.
+.RE
+.PP
+\fB\-m\fR
+.RS 4
+Nothing is printed, but mail is sent if any errors are detected\. The mail goes to the
\fBmailto\fR
address specified in the
-\fBamanda.conf\fR
+\fIamanda\.conf\fR
file or the
-\fBaddress\fR
+\fIaddress\fR
value if
-\fB-M\fR
-is set.
-.TP
-\fB-a\fR
+\fB\-M\fR
+is set\.
+.RE
+.PP
+\fB\-a\fR
+.RS 4
Like
-\fB-m\fR
-but the mail is always sent.
-.TP
-\fB-M\fR\fIaddress\fR
+\fB\-m\fR
+but the mail is always sent\.
+.RE
+.PP
+\fB\-M\fR \fIaddress\fR
+.RS 4
Mail the report to
-\fBaddress\fR
+\fIaddress\fR
instead of the
\fBmailto\fR
value from
-\fBamanda.conf\fR. Implies
-\fB-m\fR.
+\fIamanda\.conf\fR\. Implies
+\fB\-m\fR\.
+.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
+.RS 4
+See the "\fBCONFIGURATION OVERRIDE\fR" section in
+\fBamanda\fR(8)\.
+.RE
.PP
The default is
-\fB-cs\fR.
+\fB\-cs\fR\.
.SH "EXAMPLES"
.PP
-In this example, both the tape server and client tests are run. The results are displayed on standard output.
+In this example, both the tape server and client tests are run\. The results are displayed on standard output\.
.nf
-
% amcheck daily
-\fBAmanda\fR Tape Server Host Check
------------------------------
-/amanda2/amanda/work: 911475 KB disk space available, that's plenty.
-NOTE: skipping tape-writable test.
-Tape VOL10 label ok.
-Server check took 34.966 seconds.
+\fIAmanda\fR Tape Server Host Check
+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
+/amanda2/amanda/work: 911475 KB disk space available, that\'s plenty\.
+NOTE: skipping tape\-writable test\.
+Tape VOL10 label ok\.
+Server check took 34\.966 seconds\.
-\fBAmanda\fR 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.
+\fIAmanda\fR 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 \fBAmanda\fR 2.5.0)
+(brought to you by \fIAmanda\fR 2\.5\.0)
.fi
.PP
In this example, if the line
-\fBmailto csd-amanda\fR
+\fBmailto csd\-amanda\fR
is in
-\fBamanda.conf\fR, mail will be sent to
-\fBcsd-amanda\fR
-if the server check returns an error.
+\fIamanda\.conf\fR, mail will be sent to
+\fBcsd\-amanda\fR
+if the server check returns an error\.
.nf
-
-% amcheck -s -m daily
+% amcheck \-s \-m daily
.fi
.SH "MESSAGES"
-.TP
-fatal slot \fBslot\fR: \fBerror message\fR
+.PP
+fatal slot \fIslot\fR: \fIerror message\fR
+.RS 4
(error) The tape changer detected some kind of fatal error while trying to load slot
-\fBslot\fR.
-.TP
-slot \fBslot\fR: \fBerror message\fR
-(warning) The tape changer detected some kind of non-fatal error (e.g. an empty slot was detected) while trying to load slot
-\fBslot\fR, or an error was detected trying to read the tape label.
-.TP
-slot \fBslot\fR: date \fBYYYYMMDD\fR label \fBlabel\fR (\fBresult\fR)
+\fIslot\fR\.
+.RE
+.PP
+slot \fIslot\fR: \fIerror message\fR
+.RS 4
+(warning) The tape changer detected some kind of non\-fatal error (e\.g\. an empty slot was detected) while trying to load slot
+\fIslot\fR, or an error was detected trying to read the tape label\.
+.RE
+.PP
+slot \fIslot\fR: date \fIYYYYMMDD\fR label \fIlabel\fR (\fIresult\fR)
+.RS 4
(info) Tape
-\fBlabel\fR
+\fIlabel\fR
in slot
-\fBslot\fR
+\fIslot\fR
was loaded and found to have been last written on
-\fBYYYYMMDD\fR. If the tape is new, the date field will be an
-\fBX\fR. The
-\fBresult\fR
+\fIYYYYMMDD\fR\. If the tape is new, the date field will be an
+\fIX\fR\. The
+\fIresult\fR
may be one of:
-.RS
-.TP
+.PP
exact label match
-This is the expected tape.
-.TP
+.RS 4
+This is the expected tape\.
+.RE
+.PP
no match
+.RS 4
This label does not match the
\fBlabelstr\fR
pattern in
-\fBamanda.conf\fR. Tape scanning will continue.
-.TP
+\fIamanda\.conf\fR\. Tape scanning will continue\.
+.RE
+.PP
active tape
-This tape is still active and cannot be overwritten. Tape scanning will continue.
-.TP
+.RS 4
+This tape is still active and cannot be overwritten\. Tape scanning will continue\.
+.RE
+.PP
first labelstr match
+.RS 4
This tape is the first one that matches the
\fBlabelstr\fR
pattern in
-\fBamanda.conf\fR. Tape scanning will continue if necessary.
-.TP
+\fIamanda\.conf\fR\. Tape scanning will continue if necessary\.
+.RE
+.PP
labelstr match
+.RS 4
This tape is the next one that matches the
\fBlabelstr\fR
pattern in
-\fBamanda.conf\fR. Tape scanning will continue.
+\fIamanda\.conf\fR\. Tape scanning will continue\.
.RE
-.IP
-.TP
-ERROR: cannot look up dump user \fBuser\fR
+.sp
+.RE
+.PP
+ERROR: cannot look up dump user \fIuser\fR
+.RS 4
(error) Dump user
-\fBuser\fR
+\fIuser\fR
from
-\fBamanda.conf\fR
-could not be found in the system password information.
-.TP
-ERROR: cannot look up my own uid (\fBuid\fR)
+\fIamanda\.conf\fR
+could not be found in the system password information\.
+.RE
+.PP
+ERROR: cannot look up my own uid (\fIuid\fR)
+.RS 4
(error) User id
-\fBuid\fR
+\fIuid\fR
running
\fBamcheck\fR
-could not be found in the system password information.
-.TP
-ERROR: running as user \fBrunuser\fR instead of \fBdumpuser\fR
+could not be found in the system password information\.
+.RE
+.PP
+ERROR: running as user \fIrunuser\fR instead of \fIdumpuser\fR
+.RS 4
(error)
\fBAmcheck\fR
should be run as the dump user
-\fBdumpuser\fR
+\fIdumpuser\fR
from
-\fBamanda.conf\fR
+\fIamanda\.conf\fR
instead of
-\fBrunuser\fR.
-.TP
-ERROR: program dir \fBdirectory\fR: not accessible
+\fIrunuser\fR\.
+.RE
+.PP
+ERROR: program dir \fIdirectory\fR: not accessible
+.RS 4
(error) The directory
-\fBAmanda\fR
+\fIAmanda\fR
expects to find its auxiliary programs in,
-\fBdirectory\fR, is not accessible.
-.TP
-ERROR: program \fBprogram\fR: does not exist
+\fIdirectory\fR, is not accessible\.
+.RE
+.PP
+ERROR: program \fIprogram\fR: does not exist
+.RS 4
(error) Program
-\fBprogram\fR
-needed on the tape server could not be found.
-.TP
-ERROR: program \fBprogram\fR: not a file
+\fIprogram\fR
+needed on the tape server could not be found\.
+.RE
+.PP
+ERROR: program \fIprogram\fR: not a file
+.RS 4
(error) Program
-\fBprogram\fR
-needed on the tape server exists but is not a file.
-.TP
-ERROR: program \fBprogram\fR: not executable
+\fIprogram\fR
+needed on the tape server exists but is not a file\.
+.RE
+.PP
+ERROR: program \fIprogram\fR: not executable
+.RS 4
(error) Program
-\fBprogram\fR
-needed on the tape server exists but is not executable.
-.TP
-WARNING: program \fBprogram\fR: not setuid-root
+\fIprogram\fR
+needed on the tape server exists but is not executable\.
+.RE
+.PP
+WARNING: program \fIprogram\fR: not setuid\-root
+.RS 4
(warning) Program
-\fBprogram\fR
-needed on the tape server exists but should be owned by user "root" and setuid.
-.TP
-ERROR: \fBXXX\fR dir \fBdirectory\fR: not writable
+\fIprogram\fR
+needed on the tape server exists but should be owned by user "root" and setuid\.
+.RE
+.PP
+ERROR: \fIXXX\fR dir \fIdirectory\fR: not writable
+.RS 4
(error) Directory
-\fBdirectory\fR
-is either not writable, i.e. the dump user will not be able to create or remove files, or cannot be accessed, perhaps because a parent directory does not allow search permission. The
-\fBXXX\fR
+\fIdirectory\fR
+is either not writable, i\.e\. the dump user will not be able to create or remove files, or cannot be accessed, perhaps because a parent directory does not allow search permission\. The
+\fIXXX\fR
may be:
-.RS
-.TP
+.PP
log
+.RS 4
for the
-\fBAmanda\fR
+\fIAmanda\fR
log directory (see
\fBlogdir\fR
in
-\fBamanda.conf\fR)
-.TP
+\fBamanda\.conf\fR)
+.RE
+.PP
oldlog
+.RS 4
for the directory that holds the old log files (see
\fBlogdir\fR
in
-\fBamanda.conf\fR)
-.TP
+\fBamanda\.conf\fR)
+.RE
+.PP
info
+.RS 4
for an
-\fBAmanda\fR
+\fIAmanda\fR
database information directory (see
\fBcurinfo\fR
in
-\fBamanda.conf\fR) or
-.TP
+\fBamanda\.conf\fR) or
+.RE
+.PP
index
+.RS 4
for an
-\fBAmanda\fR
+\fIAmanda\fR
index directory (see
\fBindexdir\fR
in
-\fBamanda.conf\fR)
-.TP
+\fBamanda\.conf\fR)
+.RE
+.PP
tapelist
+.RS 4
for the
-\fBAmanda\fR
+\fIAmanda\fR
tapelist directory (see
\fBtapelist\fR
in
-\fBamanda.conf\fR)
+\fBamanda\.conf\fR)
+.RE
+.sp
.RE
-.IP
-.TP
-NOTE: \fBXXX\fR dir \fBdirectory\fR: does not exist
-(info) A database (info) or index directory does not exist or cannot be accessed. This might just mean this is a new client or disk, but if that is not the case, this should be treated as an error.
-.TP
+.PP
+NOTE: \fIXXX\fR dir \fIdirectory\fR: does not exist
+.RS 4
+(info) A database (info) or index directory does not exist or cannot be accessed\. This might just mean this is a new client or disk, but if that is not the case, this should be treated as an error\.
+.RE
+.PP
NOTE: it will be created on the next run
-(info) This indicates the info directory listed in the previous message will be created on the next run.
-.TP
-ERROR: \fBXXX\fR dir \fBname\fR: not a directory
+.RS 4
+(info) This indicates the info directory listed in the previous message will be created on the next run\.
+.RE
+.PP
+ERROR: \fIXXX\fR dir \fIname\fR: not a directory
+.RS 4
(error)
\fBAmcheck\fR
expected
-\fBname\fR
-to be a directory, but it is something else (e.g. file).
-.TP
+\fIname\fR
+to be a directory, but it is something else (e\.g\. file)\.
+.RE
+.PP
WARNING: info file \fIfile\fR: does not exist
+.RS 4
(warning) File
-\fBfile\fR
-does not exist in the text format database. Since the parent directories do exist, the file should already have been created.
-.TP
+\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 \fIname\fR: not a file
+.RS 4
(error)
\fBAmcheck\fR
expected
-\fBname\fR
-to be a file, but it is something else (e.g. file).
-.TP
+\fIname\fR
+to be a file, but it is something else (e\.g\. file)\.
+.RE
+.PP
ERROR: info file \fIfile\fR: not readable
+.RS 4
(error) The text format database file
-\fBfile\fR
-is not readable.
-.TP
+\fIfile\fR
+is not readable\.
+.RE
+.PP
ERROR: log file \fIfile\fR: not writable
+.RS 4
(error) Log file
-\fBfile\fR
+\fIfile\fR
(file
\fBlog\fR
in
\fBlogdir\fR
from
-\fBamanda.conf\fR) is either not writable, or cannot be accessed, perhaps because a parent directory does not allow search permission.
-.TP
-ERROR: tape list \fBtapelist\fR: not writable
+\fBamanda\.conf\fR) is either not writable, or cannot be accessed, perhaps because a parent directory does not allow search permission\.
+.RE
+.PP
+ERROR: tape list \fItapelist\fR: not writable
+.RS 4
(error)
-\fBAmanda\fR
+\fIAmanda\fR
tape list file
-\fBtapelist\fR
+\fItapelist\fR
(see
\fBtapelist\fR
in
-\fBamanda.conf\fR) is not writable or was not found.
-.TP
-ERROR: tape list \fBtapelist\fR: parse error
+\fBamanda\.conf\fR) is not writable or was not found\.
+.RE
+.PP
+ERROR: tape list \fItapelist\fR: parse error
+.RS 4
(error)
-\fBAmanda\fR
+\fIAmanda\fR
tape list file
-\fBtapelist\fR
+\fItapelist\fR
(see
\fBtapelist\fR
in
-\fBamanda.conf\fR) could not be read or parsed.
-.TP
+\fBamanda\.conf\fR) could not be read or parsed\.
+.RE
+.PP
WARNING: tapedev is /dev/null, dumps will be thrown away
+.RS 4
(warning) The
\fBtapedev\fR
parameter in
-\fBamanda.conf\fR
+\fBamanda\.conf\fR
is set to
\fI/dev/null\fR
and
-\fBAmanda\fR
-uses that when debugging to throw all the dump images away.
-.TP
+\fIAmanda\fR
+uses that when debugging to throw all the dump images away\.
+.RE
+.PP
WARNING: hold file \fIfile\fR exists
+.RS 4
(info) Hold file
-\fBfile\fR
+\fIfile\fR
exists and will cause
\fBamdump\fR
-to pause at the beginning until it is removed.
-.TP
-ERROR: holding disk \fBdisk\fR: statfs: \fBerror message\fR
+to pause at the beginning until it is removed\.
+.RE
+.PP
+ERROR: holding disk \fIdisk\fR: statfs: \fIerror message\fR
+.RS 4
(error) An error was returned from the
-\fBstatfs\fR
+\fIstatfs\fR
system call on holding disk
-\fBdisk\fR
-(maybe because it does not exist).
-.TP
-ERROR: holding disk \fBdisk\fR: not writable
+\fIdisk\fR
+(maybe because it does not exist)\.
+.RE
+.PP
+ERROR: holding disk \fIdisk\fR: not writable
+.RS 4
(error) Holding disk
-\fBdisk\fR, is not writable, probably because the caller does not have write permission or a parent directory does not allow search permission.
-.TP
-WARNING: holding disk \fBdisk\fR: available space unknown \fBN\fR KB requested.
+\fIdisk\fR, is not writable, probably because the caller does not have write permission or a parent directory does not allow search permission\.
+.RE
+.PP
+WARNING: holding disk \fIdisk\fR: available space unknown \fIN\fR KB requested\.
+.RS 4
(warning)
\fBAmcheck\fR
could not determine the amount of available space on holding disk
-\fBdisk\fR
+\fIdisk\fR
to see if there were at least
-\fBN\fR
-KBytes available.
-.TP
-WARNING: holding disk \fBdisk\fR: only \fBF\fR KB free (\fBR\fR KB requested).
+\fIN\fR
+KBytes available\.
+.RE
+.PP
+WARNING: holding disk \fIdisk\fR: only \fIF\fR KB free (\fIR\fR KB requested)\.
+.RS 4
(warning)
-\fBamanda.conf\fR
+\fIamanda\.conf\fR
requested
-\fBR\fR
+\fIR\fR
KBytes of free space on holding disk
-\fBdisk\fR, but only
-\fBF\fR
-KBytes were available. 10 MBytes is subtracted for each backup process (see the
-\fBinparallel\fR\fBamanda.conf\fR
-option) to allow for unexpected overruns.
+\fIdisk\fR, but only
+\fIF\fR
+KBytes were available\. 10 MBytes is subtracted for each backup process (see the
+\fBinparallel\fR
+\fIamanda\.conf\fR
+option) to allow for unexpected overruns\.
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
-\fBNote\fR
-Even though this message is listed as a warning, it causes \fBamcheck\fR to exit with a non-zero status..TP
-Holding disk \fBdisk\fR: \fBN\fR KB disk space available, that's plenty.
+Note
+Even though this message is listed as a warning, it causes
+\fBamcheck\fR
+to exit with a non\-zero status\.
+.RE
+.PP
+Holding disk \fIdisk\fR: \fIN\fR KB disk space available, that\'s plenty\.
+.RS 4
(info) There was sufficient free space on holding disk
-\fBdisk\fR.
-.TP
-WARNING: holding disk \fBdisk\fR: only \fBF\fR KB free, using nothing
+\fIdisk\fR\.
+.RE
+.PP
+WARNING: holding disk \fIdisk\fR: only \fIF\fR KB free, using nothing
+.RS 4
(warning) Holding disk
-\fBdisk\fR
+\fIdisk\fR
has
-\fBF\fR
+\fIF\fR
KBytes of free space, but that is not enough for what is requested in
-\fBamanda.conf\fR.
-.TP
-Holding disk \fBdisk\fR: \fBF\fR KB disk space available, using \fBU\fR KB
+\fIamanda\.conf\fR\.
+.RE
+.PP
+Holding disk \fIdisk\fR: \fIF\fR KB disk space available, using \fIU\fR KB
+.RS 4
(info) Holding disk
-\fBdisk\fR
+\fIdisk\fR
has
-\fBF\fR
+\fIF\fR
KBytes of free space and
-\fBAmanda\fR
+\fIAmanda\fR
will be using up to
-\fBU\fR
-Kbytes.
-.TP
-WARNING: if a tape changer is not available, runtapes must be set to 1.
+\fIU\fR
+Kbytes\.
+.RE
+.PP
+WARNING: if a tape changer is not available, runtapes must be set to 1\.
+.RS 4
(warning) The
-\fBruntapes\fR\fBamanda.conf\fR
+\fBruntapes\fR
+\fIamanda\.conf\fR
option must be set to 1 if the
-\fBtpchanger\fR\fBamanda.conf\fR
-option is not set.
-.TP
-ERROR: \fBerror message\fR.
-(error) An error was detected while initializing the tape changer.
-.TP
-ERROR: \fBtape device\fR: \fBerror message\fR.
-(error) An error was detected while processing the tape label.
-.TP
-ERROR: cannot overwrite active tape \fBlabel\fR.
+\fBtpchanger\fR
+\fIamanda\.conf\fR
+option is not set\.
+.RE
+.PP
+ERROR: \fIerror message\fR\.
+.RS 4
+(error) An error was detected while initializing the tape changer\.
+.RE
+.PP
+ERROR: \fItape device\fR: \fIerror message\fR\.
+.RS 4
+(error) An error was detected while processing the tape label\.
+.RE
+.PP
+ERROR: cannot overwrite active tape \fIlabel\fR\.
+.RS 4
(error) Tape
-\fBlabel\fR
-is still active and cannot be used.
-.TP
-ERROR: label \fBlabel\fR doesn't match labelstr \fBpattern\fR .
+\fIlabel\fR
+is still active and cannot be used\.
+.RE
+.PP
+ERROR: label \fIlabel\fR doesn\'t match labelstr \fIpattern\fR \.
+.RS 4
(error) The label on tape
-\fBlabel\fR
+\fIlabel\fR
does not match the
-\fBlabelstr\fR\fBamanda.conf\fR
-option.
-.TP
+\fBlabelstr\fR
+\fIamanda\.conf\fR
+option\.
+.RE
+.PP
(expecting a new tape)
-(info) The tape is not OK and a new tape was expected.
-.TP
-(expecting tape \fBlabel\fR or a new tape)
+.RS 4
+(info) The tape is not OK and a new tape was expected\.
+.RE
+.PP
+(expecting tape \fIlabel\fR or a new tape)
+.RS 4
(info) The tape is not OK and either tape
-\fBlabel\fR
-or a new tape was expected.
-.TP
-ERROR: tape \fBlabel\fR label ok, but is not writable.
+\fIlabel\fR
+or a new tape was expected\.
+.RE
+.PP
+ERROR: tape \fIlabel\fR label ok, but is not writable\.
+.RS 4
(error) Tape
-\fBlabel\fR
-is OK, but the write enable test failed.
-.TP
-Tape \fBlabel\fR is writable.
+\fIlabel\fR
+is OK, but the write enable test failed\.
+.RE
+.PP
+Tape \fIlabel\fR is writable\.
+.RS 4
(info) Tape
-\fBlabel\fR
-is OK and the write enable test succeeded.
-.TP
-NOTE: skipping tape-writable test.
+\fIlabel\fR
+is OK and the write enable test succeeded\.
+.RE
+.PP
+NOTE: skipping tape\-writable test\.
+.RS 4
(info) The tape write test (see the
-\fB-w\fR
-option) was not enabled.
-.TP
+\fB\-w\fR
+option) was not enabled\.
+.RE
+.PP
WARNING: skipping tape test because amdump or amflush seem to be running, WARNING: if they are not, you must run amcleanup
+.RS 4
(warning) It looked to
\fBamcheck\fR
like either
\fBamdump\fR
or
\fBamflush\fR
-were running because a log file or amdump file exists. If they are not running, you probably need to run
+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.
-.TP
+to clear up a previous failure\. Otherwise, you need to wait until they complete before running
+\fBamcheck\fR\.
+.RE
+.PP
NOTE: skipping tape checks
+.RS 4
(info) The tape tests are being skipped because you used the
-\fB-t\fR
-command line option.
-.TP
-WARNING: \fBcompress\fR is not executable, server-compression and indexing will not work
+\fB\-t\fR
+command line option\.
+.RE
+.PP
+WARNING: \fIcompress\fR is not executable, server\-compression and indexing will not work
+.RS 4
(warning) Compression program
-\fBcompress\fR
-is not executable, so compression on the tape server host and creating index files will not work.
-.TP
-Tape \fBlabel\fR label ok.
+\fIcompress\fR
+is not executable, so compression on the tape server host and creating index files will not work\.
+.RE
+.PP
+Tape \fIlabel\fR label ok\.
+.RS 4
(info) Tape
-\fBlabel\fR
-is OK for the next run.
-.TP
-Server check took \fBS\fR seconds.
-(info) Reports how long the tape server host checks took.
-.TP
-ERROR: \fBhost\fR: could not resolve hostname
+\fIlabel\fR
+is OK for the next run\.
+.RE
+.PP
+Server check took \fIS\fR seconds\.
+.RS 4
+(info) Reports how long the tape server host checks took\.
+.RE
+.PP
+ERROR: \fIhost\fR: could not resolve hostname
+.RS 4
(error) Could not look up client hostname
-\fBhost\fR.
-.TP
-Client check: \fBH\fR hosts checked in \fBS\fR seconds, \fBN\fR problems found.
-(info) Reports the number of client hosts checked, how long it took and the number of errors detected.
-.TP
-WARNING: \fBhost\fR: selfcheck request timed out. Host down?
+\fIhost\fR\.
+.RE
+.PP
+Client check: \fIH\fR hosts checked in \fIS\fR seconds, \fIN\fR problems found\.
+.RS 4
+(info) Reports the number of client hosts checked, how long it took and the number of errors detected\.
+.RE
+.PP
+WARNING: \fIhost\fR: selfcheck request timed out\. Host down?
+.RS 4
(warning) There was no response from
-\fBhost\fR
-when trying to do the client checks. The host might really be down or it might not be configured properly.
-.TP
-ERROR: \fBhost\fR NAK: \fBmessage\fR
+\fIhost\fR
+when trying to do the client checks\. The host might really be down or it might not be configured properly\.
+.RE
+.PP
+ERROR: \fIhost\fR NAK: \fImessage\fR
+.RS 4
(error)
-\fBHost\fR
+\fIHost\fR
reported a negative acknowledgment error of
-\fBmessage\fR
-to the status check request.
-.TP
-ERROR: \fBhost\fR NAK: [NAK parse failed]
+\fImessage\fR
+to the status check request\.
+.RE
+.PP
+ERROR: \fIhost\fR NAK: [NAK parse failed]
+.RS 4
(error)
\fBAmcheck\fR
could not parse the negative acknowledgment error from
-\fBhost\fR. There might be an
-\fBAmanda\fR
+\fIhost\fR\. There might be an
+\fIAmanda\fR
version mismatch between the host running
\fBamcheck\fR
and
-\fBhost\fR.
-.TP
-ERROR: \fBhost\fR [mutual-authentication failed]
+\fIhost\fR\.
+.RE
+.PP
+ERROR: \fIhost\fR [mutual\-authentication failed]
+.RS 4
(error) Kerberos authentication failed while contacting
-\fBhost\fR.
-.TP
-ERROR: \fBhost\fR: \fBmessage\fR
+\fIhost\fR\.
+.RE
+.PP
+ERROR: \fIhost\fR: \fImessage\fR
+.RS 4
(error) Error
-\fBmessage\fR
+\fImessage\fR
was reported by the status check on
-\fBhost\fR.
+\fIhost\fR\.
+.RE
+.SH "EXIT CODE"
+
+The exit code of \fBamcheck\fR is one of:
+.nf
+ 0 = success
+ 1 = error
+.fi
.SH "AUTHOR"
.PP
James da Silva,
-<jds@amanda.org>
+<jds@amanda\.org>
: Original text
.PP
-Stefan G. Weichinger,
-<sgw@amanda.org>, maintainer of the
-\fBAmanda\fR-documentation: XML-conversion
+Stefan G\. Weichinger,
+<sgw@amanda\.org>, maintainer of the
+\fIAmanda\fR\-documentation: XML\-conversion
.SH "SEE ALSO"
.PP
\fBamanda\fR(8),
-\fBamdump\fR(8)
-
+\fBamdump\fR(8),
+: http://wiki.zmanda.com
projects / debian / amanda / blobdiff