Imported Upstream version 3.2.0

[debian/amanda] / man / amcheck.8

diff --git a/man/amcheck.8 b/man/amcheck.8
index 657df5610204fad9df8fa7adcbdbf1b23d2bc755..d0286b246937fb29979230c7232523b76c3c222c 100644 (file)
--- a/man/amcheck.8
+++ b/man/amcheck.8
@@ -1,547 +1,680 @@
-.\"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 "" "" ""
+'\" t
+.\"     Title: amcheck
+.\"    Author: James da Silva <jds@amanda.org>
+.\" Generator: DocBook XSL Stylesheets vsnapshot_8273 <http://docbook.sf.net/>
+.\"      Date: 10/18/2010
+.\"    Manual: System Administration Commands
+.\"    Source: Amanda 3.2.0
+.\"  Language: English
+.\"
+.TH "AMCHECK" "8" "10/18/2010" "Amanda 3\&.2\&.0" "System Administration Commands"
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------

 .SH "NAME"
 .SH "NAME"

-amcheck - run Amanda self-checks
+amcheck \- run Amanda self\-checks

 .SH "SYNOPSIS"
 .SH "SYNOPSIS"

-.HP 8
-\fBamcheck\fR [-mwsclt] [-Maddress] \fIconfig\fR [\fIhost\fR [\fIdisk\fR...]...]
+.HP \w'\fBamcheck\fR\ 'u
+\fBamcheck\fR [\-am] [\-w] [\-sclt] [\-M\ \fIaddress\fR] \fIconfig\fR [\fIhost\fR\ [\fIdisk\fR...]...] [\fB\-o\fR\ \fIconfigoption\fR...]

 .SH "DESCRIPTION"
 .PP
 \fBAmcheck\fR
 .SH "DESCRIPTION"
 .PP
 \fBAmcheck\fR

-runs a number of self-checks on both the
-\fBAmanda\fR
-tape server host and the
-\fBAmanda\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
 can go through the same tape checking used at the start of the nightly
 \fBamdump\fR
 .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
 .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
 .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)
 .PP
 See the
 \fBamanda\fR(8)

-man page for more details about
-\fBAmanda\fR.
+man page for more details about Amanda\&.

 .SH "OPTIONS"
 .SH "OPTIONS"

-.TP
-\fB-s\fR
+.PP
+\fB\-s\fR
+.RS 4

 Run the tape server local and tape checks (same as
 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
 \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
+\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
+.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
 \fBmailto\fR
 address specified in the

-\fBamanda.conf\fR
+\fIamanda\&.conf\fR

 file or the
 file or the

-\fBaddress\fR
+\fIaddress\fR

 value if
 value if

-\fB-M\fR
-is set.
-.TP
-\fB-a\fR
+\fB\-M\fR
+is set\&.
+.RE
+.PP
+\fB\-a\fR
+.RS 4

 Like
 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
 Mail the report to

-\fBaddress\fR
+\fIaddress\fR

 instead of the
 \fBmailto\fR
 value from
 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\fB\fIconfigoption\fR\fR
+.RS 4
+See the "CONFIGURATION OVERRIDE" section in
+\fBamanda\fR(8)\&.
+.RE

 .PP
 The default is
 .PP
 The default is

-\fB-cs\fR.
+\fB\-cs\fR\&.

 .SH "EXAMPLES"
 .PP
 .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
 .nf

-

 % amcheck daily
 % 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.
+Amanda 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.
+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 \fBAmanda\fR 2.5.0) 
+(brought to you by Amanda 2\&.5\&.0) 

 .fi
 .PP
 In this example, if the line
 .fi
 .PP
 In this example, if the line

-\fBmailto csd-amanda\fR
+\fBmailto csd\-amanda\fR

 is in
 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
 .nf

-
-% amcheck -s -m daily 
+% amcheck \-s \-m daily 

 .fi
 .SH "MESSAGES"
 .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
 (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
 (info) Tape

-\fBlabel\fR
+\fIlabel\fR

 in slot
 in slot

-\fBslot\fR
+\fIslot\fR

 was loaded and found to have been last written on
 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:
 may be one of:

-.RS
-.TP
+.PP

 exact label match
 exact label match

-This is the expected tape.
-.TP
+.RS 4
+This is the expected tape\&.
+.RE
+.PP

 no match
 no match

+.RS 4

 This label does not match the
 \fBlabelstr\fR
 pattern in
 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
 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
 first labelstr match

+.RS 4

 This tape is the first one that matches the
 \fBlabelstr\fR
 pattern in
 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
 labelstr match

+.RS 4

 This tape is the next one that matches the
 \fBlabelstr\fR
 pattern in
 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
 .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
 (error) Dump user

-\fBuser\fR
+\fIuser\fR

 from
 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
 (error) User id

-\fBuid\fR
+\fIuid\fR

 running
 \fBamcheck\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
 (error)
 \fBAmcheck\fR
 should be run as the dump user

-\fBdumpuser\fR
+\fIdumpuser\fR

 from
 from

-\fBamanda.conf\fR
+\fIamanda\&.conf\fR

 instead of
 instead of

-\fBrunuser\fR.
-.TP
-ERROR: program dir \fBdirectory\fR: not accessible
-(error) The directory
-\fBAmanda\fR
-expects to find its auxiliary programs in,
-\fBdirectory\fR, is not accessible.
-.TP
-ERROR: program \fBprogram\fR: does not exist
+\fIrunuser\fR\&.
+.RE
+.PP
+ERROR: program dir \fIdirectory\fR: not accessible
+.RS 4
+(error) The directory Amanda expects to find its auxiliary programs in,
+\fIdirectory\fR, is not accessible\&.
+.RE
+.PP
+ERROR: program \fIprogram\fR: does not exist
+.RS 4

 (error) Program
 (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
 (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
 (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
 (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
 (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:
 may be:

-.RS
-.TP
+.PP

 log
 log

-for the
-\fBAmanda\fR
-log directory (see
+.RS 4
+for the Amanda log directory (see

 \fBlogdir\fR
 in
 \fBlogdir\fR
 in

-\fBamanda.conf\fR)
-.TP
+\fBamanda\&.conf\fR)
+.RE
+.PP

 oldlog
 oldlog

+.RS 4

 for the directory that holds the old log files (see
 \fBlogdir\fR
 in
 for the directory that holds the old log files (see
 \fBlogdir\fR
 in

-\fBamanda.conf\fR)
-.TP
+\fBamanda\&.conf\fR)
+.RE
+.PP

 info
 info

-for an
-\fBAmanda\fR
-database information directory (see
+.RS 4
+for an Amanda database information directory (see

 \fBcurinfo\fR
 in
 \fBcurinfo\fR
 in

-\fBamanda.conf\fR) or
-.TP
+\fBamanda\&.conf\fR) or
+.RE
+.PP

 index
 index

-for an
-\fBAmanda\fR
-index directory (see
+.RS 4
+for an Amanda index directory (see

 \fBindexdir\fR
 in
 \fBindexdir\fR
 in

-\fBamanda.conf\fR)
-.TP
+\fBamanda\&.conf\fR)
+.RE
+.PP

 tapelist
 tapelist

+.RS 4

 for the
 for the

-\fBAmanda\fR
-tapelist directory (see
-\fBtapelist\fR
-in
-\fBamanda.conf\fR)
+\fBtapelist\fR(5)
+.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
 .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
 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
 (error)
 \fBAmcheck\fR
 expected

-\fBname\fR
-to be a directory, but it is something else (e.g. file).
-.TP
-WARNING: info file \fIfile\fR: does not exist
+\fIname\fR
+to be a directory, but it is something else (e\&.g\&. file)\&.
+.RE
+.PP
+WARNING: info file file: does not exist
+.RS 4

 (warning) File
 (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
-ERROR: info file \fIname\fR: not a 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 name: not a file
+.RS 4

 (error)
 \fBAmcheck\fR
 expected
 (error)
 \fBAmcheck\fR
 expected

-\fBname\fR
-to be a file, but it is something else (e.g. file).
-.TP
-ERROR: info file \fIfile\fR: not readable
+\fIname\fR
+to be a file, but it is something else (e\&.g\&. file)\&.
+.RE
+.PP
+ERROR: info file file: not readable
+.RS 4

 (error) The text format database file
 (error) The text format database file

-\fBfile\fR
-is not readable.
-.TP
-ERROR: log file \fIfile\fR: not writable
+\fIfile\fR
+is not readable\&.
+.RE
+.PP
+ERROR: log file file: not writable
+.RS 4

 (error) Log file
 (error) Log file

-\fBfile\fR
+\fIfile\fR

 (file
 \fBlog\fR
 in
 \fBlogdir\fR
 from
 (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)
 (error)

-\fBAmanda\fR
-tape list file
-\fBtapelist\fR
-(see
-\fBtapelist\fR
-in
-\fBamanda.conf\fR) is not writable or was not found.
-.TP
-ERROR: tape list \fBtapelist\fR: parse error
+\fBtapelist\fR(5)
+is not writable or was not found\&.
+.RE
+.PP
+ERROR: tape list \fItapelist\fR: parse error
+.RS 4

 (error)
 (error)

-\fBAmanda\fR
-tape list file
-\fBtapelist\fR
-(see
-\fBtapelist\fR
-in
-\fBamanda.conf\fR) could not be read or parsed.
-.TP
+\fBtapelist\fR(5)
+could not be read or parsed\&.
+.RE
+.PP

 WARNING: tapedev is /dev/null, dumps will be thrown away
 WARNING: tapedev is /dev/null, dumps will be thrown away

+.RS 4

 (warning) The
 \fBtapedev\fR
 parameter in
 (warning) The
 \fBtapedev\fR
 parameter in

-\fBamanda.conf\fR
+\fBamanda\&.conf\fR

 is set to
 is set to

-\fI/dev/null\fR
-and
-\fBAmanda\fR
-uses that when debugging to throw all the dump images away.
-.TP
-WARNING: hold file \fIfile\fR exists
+/dev/null
+and Amanda uses that when debugging to throw all the dump images away\&.
+.RE
+.PP
+WARNING: hold file file exists
+.RS 4

 (info) Hold file
 (info) Hold file

-\fBfile\fR
+\fIfile\fR

 exists and will cause
 \fBamdump\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
 (error) An error was returned from the

-\fBstatfs\fR
+\fIstatfs\fR

 system call on holding disk
 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
 (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
 (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
 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)
 (warning)

-\fBamanda.conf\fR
+\fIamanda\&.conf\fR

 requested
 requested

-\fBR\fR
+\fIR\fR

 KBytes of free space on holding disk
 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\&.
+.if n \{\

 .sp
 .sp

+.\}
+.RS 4

 .it 1 an-trap
 .nr an-no-space-flag 1
 .nr an-break-flag 1
 .br
 .it 1 an-trap
 .nr an-no-space-flag 1
 .nr an-break-flag 1
 .br

+.ps +1

 \fBNote\fR
 \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.
+.ps -1
+.br
+Even though this message is listed as a warning, it causes
+\fBamcheck\fR
+to exit with a non\-zero status\&.
+.sp .5v
+.RE
+.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
 (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
 (warning) Holding disk

-\fBdisk\fR
+\fIdisk\fR

 has
 has

-\fBF\fR
+\fIF\fR

 KBytes of free space, but that is not enough for what is requested in
 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
 (info) Holding disk

-\fBdisk\fR
+\fIdisk\fR

 has
 has

-\fBF\fR
-KBytes of free space and
-\fBAmanda\fR
-will be using up to
-\fBU\fR
-Kbytes.
-.TP
-WARNING: if a tape changer is not available, runtapes must be set to 1.
+\fIF\fR
+KBytes of free space and Amanda will be using up to
+\fIU\fR
+Kbytes\&.
+.RE
+.PP
+WARNING: if a tape changer is not available, runtapes must be set to 1\&.
+.RS 4

 (warning) The
 (warning) The

-\fBruntapes\fR\fBamanda.conf\fR
+\fBruntapes\fR
+\fIamanda\&.conf\fR

 option must be set to 1 if the
 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
 (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
 (error) The label on tape

-\fBlabel\fR
+\fIlabel\fR

 does not match the
 does not match the

-\fBlabelstr\fR\fBamanda.conf\fR
-option.
-.TP
+\fBlabelstr\fR
+\fIamanda\&.conf\fR
+option\&.
+.RE
+.PP

 (expecting a new tape)
 (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
 (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
 (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
 (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
 (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
 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
 (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
 \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
 NOTE: skipping tape checks

+.RS 4

 (info) The tape tests are being skipped because you used the
 (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
 (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
 (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
 (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
 (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)
 (error)

-\fBHost\fR
+\fIHost\fR

 reported a negative acknowledgment error of
 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
 (error)
 \fBAmcheck\fR
 could not parse the negative acknowledgment error from

-\fBhost\fR. There might be an
-\fBAmanda\fR
-version mismatch between the host running
+\fIhost\fR\&. There might be an Amanda version mismatch between the host running

 \fBamcheck\fR
 and
 \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
 (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
 (error) Error

-\fBmessage\fR
+\fImessage\fR

 was reported by the status check on
 was reported by the status check on

-\fBhost\fR.
-.SH "AUTHOR"
-.PP
-James da Silva,
-<jds@amanda.org>
-: Original text
-.PP
-Stefan G. Weichinger,
-<sgw@amanda.org>, maintainer of the
-\fBAmanda\fR-documentation: XML-conversion
+\fIhost\fR\&.
+.RE
+.SH "EXIT CODE"
+
+The exit code of \fBamcheck\fR is one of:
+.nf
+ 0  = success
+ 1  = error
+.fi

 .SH "SEE ALSO"
 .PP
 \fBamanda\fR(8),
 .SH "SEE ALSO"
 .PP
 \fBamanda\fR(8),

+\fBamanda.conf\fR(5),

 \fBamdump\fR(8)
 \fBamdump\fR(8)

-
+.PP
+The Amanda Wiki:
+: http://wiki.zmanda.com/
+.SH "AUTHORS"
+.PP
+\fBJames da Silva\fR <\&jds@amanda\&.org\&>
+.PP
+\fBStefan G\&. Weichinger\fR <\&sgw@amanda\&.org\&>