X-Git-Url: https://git.gag.com/?a=blobdiff_plain;f=man%2Famcheck.8;h=e4d7f6fc45ec26bb990c10aa0622d43b85a99705;hb=fb2bd066c2f8b34addafe48d62550e3033a59431;hp=4483818789cf5a13b984bc18ac5b7681f1b71aa1;hpb=12179dea039515c06168c0037d048566a3f623de;p=debian%2Famanda

diff --git a/man/amcheck.8 b/man/amcheck.8
index 4483818..e4d7f6f 100644
--- a/man/amcheck.8
+++ b/man/amcheck.8
@@ -1,555 +1,696 @@
-.\"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 [-am] [-w] [-sclt] [-M \fIaddress\fR]*
-     \fIconfig\fR [\fIhost\fR [\fIdisk\fR]*]*
-     [-o \fIconfigoption\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.Multiple specific clients can be checked by specifying the client name.
-.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 enable the tape tests on the server host 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.
-.TP
+\fIamanda\.conf\fR\. Implies
+\fB\-m\fR\.
+.RE
+.PP
 \fIhost\fR [\fIdisk\fR]*
-Specify the host and disk on which the command will work.
-.TP
-\fB-o\fR \fIconfigoption\fR
-See the "\fBCONFIGURATION OVERWRITE\fR" section in
-\fBamanda\fR(8).
+.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
+.sp
 .RE
-.IP
-.TP
-ERROR: cannot look up dump user \fBuser\fR
+.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
+.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
-.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: 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