<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"
[
<!-- entities files to use -->
<!ENTITY % global_entities SYSTEM 'global.entities'>
%global_entities;
]>
<!-- lifted from troff+man by doclifter -->
<refentry id='amcheck.8'>
<refmeta>
<refentrytitle>amcheck</refentrytitle>
<manvolnum>8</manvolnum>
&rmi.source;
&rmi.version;
&rmi.manual.8;
</refmeta>
<refnamediv>
<refname>amcheck</refname>
<refpurpose>run Amanda self-checks</refpurpose>
</refnamediv>
<refentryinfo>
&author.jds;
&author.sgw.xml;
</refentryinfo>
<!-- body begins here -->
<refsynopsisdiv>
<cmdsynopsis>
<command>amcheck</command>
<arg choice='opt'>-am</arg>
<arg choice='opt'>-w</arg>
<arg choice='opt'>-sclt</arg>
<arg choice='opt'>-M <replaceable>address</replaceable></arg>
<arg choice='opt'>--client-verbose</arg>
<arg choice='opt'>--exact-match</arg>
&configoverride.synopsis;
<arg choice='plain'><replaceable>config</replaceable></arg>
<arg choice='opt' rep='repeat'>
<arg choice='plain'><replaceable>host</replaceable></arg>
<arg choice='opt' rep='repeat'><replaceable>disk</replaceable></arg>
</arg>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1><title>DESCRIPTION</title>
<para><emphasis remap='B'>Amcheck</emphasis>
runs a number of self-checks on both the Amanda tape server host and
the Amanda client hosts.</para>
<para>On the tape server host,
<command>amcheck</command>
can go through the same tape checking used at the start of the nightly
<emphasis remap='B'>amdump</emphasis>
run to verify the correct tape for the next run is mounted.</para>
<para><emphasis remap='B'>Amcheck</emphasis>
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.</para>
<para>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.</para>
<para>See the
<manref name="amanda" vol="8"/>
man page for more details about Amanda.</para>
</refsect1>
<refsect1><title>OPTIONS</title>
<variablelist remap='TP'>
<varlistentry>
<term><option>-s</option></term>
<listitem>
<para>Run the tape server local and tape checks (same as
<option>-lt</option>).</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-c</option></term>
<listitem>
<para>Run the client host checks. Multiple specific clients can be
checked by specifying the client name.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-l</option></term>
<listitem>
<para>Run the local tests (e.g. permissions) on the server host.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-t</option></term>
<listitem>
<para>Run the tape tests on the server host.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-w</option></term>
<listitem>
<para>Enables a DESTRUCTIVE check for write-protection on the
tape (which would otherwise cause the subsequent
<emphasis remap='B'>amdump</emphasis>
to fail).
If the tape
is writable, this check causes all data after the tape label to be
erased. If the <amkeyword>autolabel</amkeyword> 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.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-m</option></term>
<listitem>
<para>Nothing is printed, but mail is sent if any errors are detected.
The mail goes to the
<emphasis remap='B'>mailto</emphasis>
address specified in the
<emphasis remap='I'>amanda.conf</emphasis>
file or the
<emphasis remap='I'>address</emphasis>
value if
<option>-M</option>
is set.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-a</option></term>
<listitem>
<para>Like
<option>-m</option>
but the mail is always sent.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-M</option> <replaceable>address</replaceable></term>
<listitem>
<para>Mail the report to
<emphasis remap='I'>address</emphasis>
instead of the
<emphasis remap='B'>mailto</emphasis>
value from
<emphasis remap='I'>amanda.conf</emphasis>.
Implies
<option>-m</option>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>--client-verbose</option></term>
<listitem>
<para>Print all client messages.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>--exact-match</option></term>
<listitem>
<para>The host and disk are parsed as exact values</para>
</listitem>
</varlistentry>
<varlistentry>
<term><replaceable>host</replaceable> [<replaceable>disk</replaceable>]*</term>
<listitem>
<para>Specify the host and disk on which the command will work.</para>
</listitem>
</varlistentry>
&configoverride.varlistentry;
</variablelist>
<para>The default is
<option>-cs</option>.</para>
</refsect1>
<refsect1><title>EXAMPLES</title>
<para>In this example, both the tape server and client tests are run.
The results are displayed on standard output.</para>
<programlisting>
% amcheck daily
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.
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 Amanda 2.5.0)
</programlisting>
<para>In this example, if the line
<emphasis remap='B'>mailto csd-amanda</emphasis>
is in
<emphasis remap='I'>amanda.conf</emphasis>,
mail will be sent to
<emphasis remap='B'>csd-amanda</emphasis>
if the server check returns an error.</para>
<programlisting>
% amcheck -s -m daily
</programlisting>
</refsect1>
<refsect1><title>MESSAGES</title>
<variablelist remap='TP'>
<varlistentry>
<term>fatal slot <emphasis remap='I'>slot</emphasis>: <emphasis remap='I'>error message</emphasis></term>
<listitem>
<para>(error)
The tape changer detected some kind of fatal error while trying to load slot
<emphasis remap='I'>slot</emphasis>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>slot <emphasis remap='I'>slot</emphasis>: <emphasis remap='I'>error message</emphasis></term>
<listitem>
<para>(warning)
The tape changer detected some kind of non-fatal error
(e.g. an empty slot was detected)
while trying to load slot
<emphasis remap='I'>slot</emphasis>,
or an error was detected trying to read the tape label.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>slot <emphasis remap='I'>slot</emphasis>: date <emphasis remap='I'>YYYYMMDD</emphasis> label <emphasis remap='I'>label</emphasis> (<emphasis remap='I'>result</emphasis>)</term>
<listitem>
<para>(info)
Tape
<emphasis remap='I'>label</emphasis>
in slot
<emphasis remap='I'>slot</emphasis>
was loaded and found to have been last written on
<emphasis remap='I'>YYYYMMDD</emphasis>.
If the tape is new, the date field will be an
<emphasis remap='I'>X</emphasis>.
The
<emphasis remap='I'>result</emphasis>
may be one of:</para>
<!-- .RS -->
<variablelist remap='TP'>
<varlistentry>
<term>exact label match</term>
<listitem>
<para>This is the expected tape.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>no match</term>
<listitem>
<para>This label does not match the
<emphasis remap='B'>labelstr</emphasis>
pattern in
<emphasis remap='I'>amanda.conf</emphasis>.
Tape scanning will continue.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>active tape</term>
<listitem>
<para>This tape is still active and cannot be overwritten.
Tape scanning will continue.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>first labelstr match</term>
<listitem>
<para>This tape is the first one that matches the
<emphasis remap='B'>labelstr</emphasis>
pattern in
<emphasis remap='I'>amanda.conf</emphasis>.
Tape scanning will continue if necessary.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>labelstr match</term>
<listitem>
<para>This tape is the next one that matches the
<emphasis remap='B'>labelstr</emphasis>
pattern in
<emphasis remap='I'>amanda.conf</emphasis>.
Tape scanning will continue.</para>
</listitem>
</varlistentry>
</variablelist>
<!-- .RE -->
</listitem>
</varlistentry>
<varlistentry>
<term>ERROR: cannot look up dump user <emphasis remap='I'>user</emphasis></term>
<listitem>
<para>(error)
Dump user
<emphasis remap='I'>user</emphasis>
from
<emphasis remap='I'>amanda.conf</emphasis>
could not be found in the system password information.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>ERROR: cannot look up my own uid (<emphasis remap='I'>uid</emphasis>)</term>
<listitem>
<para>(error)
User id
<emphasis remap='I'>uid</emphasis>
running
<command>amcheck</command>
could not be found in the system password information.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>ERROR: running as user <emphasis remap='I'>runuser</emphasis> instead of <emphasis remap='I'>dumpuser</emphasis></term>
<listitem>
<para>(error)
<emphasis remap='B'>Amcheck</emphasis>
should be run as the dump user
<emphasis remap='I'>dumpuser</emphasis>
from
<emphasis remap='I'>amanda.conf</emphasis>
instead of
<emphasis remap='I'>runuser</emphasis>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>ERROR: program dir <emphasis remap='I'>directory</emphasis>: not accessible</term>
<listitem>
<para>(error)
The directory Amanda expects to find its auxiliary programs in,
<emphasis remap='I'>directory</emphasis>,
is not accessible.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>ERROR: program <emphasis remap='I'>program</emphasis>: does not exist</term>
<listitem>
<para>(error)
Program
<emphasis remap='I'>program</emphasis>
needed on the tape server could not be found.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>ERROR: program <emphasis remap='I'>program</emphasis>: not a file</term>
<listitem>
<para>(error)
Program
<emphasis remap='I'>program</emphasis>
needed on the tape server exists but is not a file.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>ERROR: program <emphasis remap='I'>program</emphasis>: not executable</term>
<listitem>
<para>(error)
Program
<emphasis remap='I'>program</emphasis>
needed on the tape server exists but is not executable.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>WARNING: program <emphasis remap='I'>program</emphasis>: not setuid-root</term>
<listitem>
<para>(warning)
Program
<emphasis remap='I'>program</emphasis>
needed on the tape server exists but should be owned by user "root"
and setuid.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>ERROR: <emphasis remap='I'>XXX</emphasis> dir <emphasis remap='I'>directory</emphasis>: not writable</term>
<listitem>
<para>(error)
Directory
<emphasis remap='I'>directory</emphasis>
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
<emphasis remap='I'>XXX</emphasis>
may be:</para>
<!-- .RS -->
<variablelist remap='TP'>
<varlistentry>
<term>log</term>
<listitem>
<para>for the Amanda log directory (see
<emphasis remap='B'>logdir</emphasis>
in
<emphasis remap='B'>amanda.conf</emphasis>)</para>
</listitem>
</varlistentry>
<varlistentry>
<term>oldlog</term>
<listitem>
<para>for the directory that holds the old log files (see
<emphasis remap='B'>logdir</emphasis>
in
<emphasis remap='B'>amanda.conf</emphasis>)</para>
</listitem>
</varlistentry>
<varlistentry>
<term>info</term>
<listitem>
<para>for an Amanda database information directory (see
<emphasis remap='B'>curinfo</emphasis>
in
<emphasis remap='B'>amanda.conf</emphasis>)
or</para>
</listitem>
</varlistentry>
<varlistentry>
<term>index</term>
<listitem>
<para>for an Amanda index directory (see
<emphasis remap='B'>indexdir</emphasis>
in
<emphasis remap='B'>amanda.conf</emphasis>)</para>
</listitem>
</varlistentry>
<varlistentry>
<term>tapelist</term>
<listitem>
<para>for the &tapelist;</para>
</listitem>
</varlistentry>
</variablelist>
<!-- .RE -->
</listitem>
</varlistentry>
<varlistentry>
<term>NOTE: <emphasis remap='I'>XXX</emphasis> dir <emphasis remap='I'>directory</emphasis>: does not exist</term>
<listitem>
<para>(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.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>NOTE: it will be created on the next run</term>
<listitem>
<para>(info)
This indicates the info directory listed in the previous message
will be created on the next run.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>ERROR: <emphasis remap='I'>XXX</emphasis> dir <emphasis remap='I'>name</emphasis>: not a directory</term>
<listitem>
<para>(error)
<emphasis remap='B'>Amcheck</emphasis>
expected
<emphasis remap='I'>name</emphasis>
to be a directory,
but it is something else (e.g. file).</para>
</listitem>
</varlistentry>
<varlistentry>
<term>WARNING: info file <filename>file</filename>: does not exist</term>
<listitem>
<para>(warning)
File
<emphasis remap='I'>file</emphasis>
does not exist in the text format database.
Since the parent directories do exist,
the file should already have been created.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>ERROR: info file <filename>name</filename>: not a file</term>
<listitem>
<para>(error)
<emphasis remap='B'>Amcheck</emphasis>
expected
<emphasis remap='I'>name</emphasis>
to be a file,
but it is something else (e.g. file).</para>
</listitem>
</varlistentry>
<varlistentry>
<term>ERROR: info file <filename>file</filename>: not readable</term>
<listitem>
<para>(error)
The text format database file
<emphasis remap='I'>file</emphasis>
is not readable.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>ERROR: log file <filename>file</filename>: not writable</term>
<listitem>
<para>(error)
Log file
<emphasis remap='I'>file</emphasis>
(file
<emphasis remap='B'>log</emphasis>
in
<emphasis remap='B'>logdir</emphasis>
from
<emphasis remap='B'>amanda.conf</emphasis>)
is either not writable,
or cannot be accessed, perhaps because a parent directory
does not allow search permission.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>ERROR: tape list <emphasis remap='I'>tapelist</emphasis>: not writable</term>
<listitem>
<para>(error) &tapelist; is not writable or was not found.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>ERROR: tape list <emphasis remap='I'>tapelist</emphasis>: parse error</term>
<listitem>
<para>(error) &tapelist; could not be read or parsed.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>WARNING: tapedev is /dev/null, dumps will be thrown away</term>
<listitem>
<para>(warning)
The
<emphasis remap='B'>tapedev</emphasis>
parameter in
<emphasis remap='B'>amanda.conf</emphasis>
is set to
<filename>/dev/null</filename>
and Amanda uses that when debugging to throw all the dump images away.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>WARNING: hold file <filename>file</filename> exists</term>
<listitem>
<para>(info)
Hold file
<emphasis remap='I'>file</emphasis>
exists and will cause
<emphasis remap='B'>amdump</emphasis>
to pause at the beginning until it is removed.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>ERROR: holding disk <emphasis remap='I'>disk</emphasis>: statfs: <emphasis remap='I'>error message</emphasis></term>
<listitem>
<para>(error)
An error was returned from the
<emphasis remap='I'>statfs</emphasis>
system call on holding disk
<emphasis remap='I'>disk</emphasis>
(maybe because it does not exist).</para>
</listitem>
</varlistentry>
<varlistentry>
<term>ERROR: holding disk <emphasis remap='I'>disk</emphasis>: not writable</term>
<listitem>
<para>(error)
Holding disk
<emphasis remap='I'>disk</emphasis>,
is not writable,
probably because the caller does not have write permission
or a parent directory does not allow search permission.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>WARNING: holding disk <emphasis remap='I'>disk</emphasis>: available space unknown <emphasis remap='I'>N</emphasis> KB requested.</term>
<listitem>
<para>(warning)
<emphasis remap='B'>Amcheck</emphasis>
could not determine the amount of available space on holding disk
<emphasis remap='I'>disk</emphasis>
to see if there were at least
<emphasis remap='I'>N</emphasis>
KBytes available.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>WARNING: holding disk <emphasis remap='I'>disk</emphasis>: only <emphasis remap='I'>F</emphasis> KB free (<emphasis remap='I'>R</emphasis> KB requested).</term>
<listitem>
<para>(warning)
<emphasis remap='I'>amanda.conf</emphasis>
requested
<emphasis remap='I'>R</emphasis>
KBytes of free space on holding disk
<emphasis remap='I'>disk</emphasis>,
but only
<emphasis remap='I'>F</emphasis>
KBytes were available.
10 MBytes is subtracted for each backup process
(see the
<emphasis remap='B'>inparallel</emphasis>
<emphasis remap='I'>amanda.conf</emphasis>
option)
to allow for unexpected overruns.</para>
<note><para>Even though this message is listed as a warning, it causes &amcheck; to exit with a non-zero status.</para>
</note>
</listitem>
</varlistentry>
</variablelist>
<variablelist remap='TP'>
<varlistentry>
<term>Holding disk <emphasis remap='I'>disk</emphasis>: <emphasis remap='I'>N</emphasis> KB disk space available, that's plenty.</term>
<listitem>
<para>(info)
There was sufficient free space on holding disk
<emphasis remap='I'>disk</emphasis>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>WARNING: holding disk <emphasis remap='I'>disk</emphasis>: only <emphasis remap='I'>F</emphasis> KB free, using nothing</term>
<listitem>
<para>(warning)
Holding disk
<emphasis remap='I'>disk</emphasis>
has
<emphasis remap='I'>F</emphasis>
KBytes of free space, but that is not enough for what is requested in
<emphasis remap='I'>amanda.conf</emphasis>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Holding disk <emphasis remap='I'>disk</emphasis>: <emphasis remap='I'>F</emphasis> KB disk space available, using <emphasis remap='I'>U</emphasis> KB</term>
<listitem>
<para>(info)
Holding disk
<emphasis remap='I'>disk</emphasis>
has
<emphasis remap='I'>F</emphasis>
KBytes of free space and Amanda will be using up to
<emphasis remap='I'>U</emphasis>
Kbytes.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>WARNING: if a tape changer is not available, runtapes must be set to 1.</term>
<listitem>
<para>(warning)
The
<emphasis remap='B'>runtapes</emphasis>
<emphasis remap='I'>amanda.conf</emphasis>
option must be set to 1 if the
<emphasis remap='B'>tpchanger</emphasis>
<emphasis remap='I'>amanda.conf</emphasis>
option is not set.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>ERROR: <emphasis remap='I'>error message</emphasis>.</term>
<listitem>
<para>(error)
An error was detected while initializing the tape changer.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>ERROR: <emphasis remap='I'>tape device</emphasis>: <emphasis remap='I'>error message</emphasis>.</term>
<listitem>
<para>(error)
An error was detected while processing the tape label.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>ERROR: cannot overwrite active tape <emphasis remap='I'>label</emphasis>.</term>
<listitem>
<para>(error)
Tape
<emphasis remap='I'>label</emphasis>
is still active and cannot be used.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>ERROR: label <emphasis remap='I'>label</emphasis> doesn't match labelstr <emphasis remap='I'>pattern</emphasis> .</term>
<listitem>
<para>(error)
The label on tape
<emphasis remap='I'>label</emphasis>
does not match the
<emphasis remap='B'>labelstr</emphasis>
<emphasis remap='I'>amanda.conf</emphasis>
option.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>(expecting a new tape)</term>
<listitem>
<para>(info)
The tape is not OK and a new tape was expected.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>(expecting tape <emphasis remap='I'>label</emphasis> or a new tape)</term>
<listitem>
<para>(info)
The tape is not OK and either tape
<emphasis remap='I'>label</emphasis>
or a new tape was expected.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>ERROR: tape <emphasis remap='I'>label</emphasis> label ok, but is not writable.</term>
<listitem>
<para>(error)
Tape
<emphasis remap='I'>label</emphasis>
is OK, but the write enable test failed.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Tape <emphasis remap='I'>label</emphasis> is writable.</term>
<listitem>
<para>(info)
Tape
<emphasis remap='I'>label</emphasis>
is OK and the write enable test succeeded.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>NOTE: skipping tape-writable test.</term>
<listitem>
<para>(info)
The tape write test (see the
<option>-w</option>
option) was not enabled.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>WARNING: skipping tape test because amdump or amflush seem to be running</term>
<term>WARNING: if they are not, you must run amcleanup</term>
<listitem>
<para>(warning)
It looked to
<command>amcheck</command>
like either
<emphasis remap='B'>amdump</emphasis>
or
<emphasis remap='B'>amflush</emphasis>
were running because a log file or amdump file exists.
If they are not running, you probably need to run
<emphasis remap='B'>amcleanup</emphasis>
to clear up a previous failure.
Otherwise, you need to wait until they complete before running
<command>amcheck</command><literal>.</literal></para>
</listitem>
</varlistentry>
<varlistentry>
<term>NOTE: skipping tape checks</term>
<listitem>
<para>(info)
The tape tests are being skipped because you used the
<option>-t</option>
command line option.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>WARNING: <emphasis remap='I'>compress</emphasis> is not executable, server-compression and indexing will not work</term>
<listitem>
<para>(warning)
Compression program
<emphasis remap='I'>compress</emphasis>
is not executable,
so compression on the tape server host and creating index files will not work.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Tape <emphasis remap='I'>label</emphasis> label ok.</term>
<listitem>
<para>(info)
Tape
<emphasis remap='I'>label</emphasis>
is OK for the next
run.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Server check took <emphasis remap='I'>S</emphasis> seconds.</term>
<listitem>
<para>(info)
Reports how long the tape server host checks took.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>ERROR: <emphasis remap='I'>host</emphasis>: could not resolve hostname</term>
<listitem>
<para>(error)
Could not look up client hostname
<emphasis remap='I'>host</emphasis>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Client check: <emphasis remap='I'>H</emphasis> hosts checked in <emphasis remap='I'>S</emphasis> seconds, <emphasis remap='I'>N</emphasis> problems found.</term>
<listitem>
<para>(info)
Reports the number of client hosts checked,
how long it took and the number of errors detected.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>WARNING: <emphasis remap='I'>host</emphasis>: selfcheck request timed out. Host down?</term>
<listitem>
<para>(warning)
There was no response from
<emphasis remap='I'>host</emphasis>
when trying to do the client checks.
The host might really be down or it might not be configured properly.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>ERROR: <emphasis remap='I'>host</emphasis> NAK: <emphasis remap='I'>message</emphasis></term>
<listitem>
<para>(error)
<emphasis remap='I'>Host</emphasis>
reported a negative acknowledgment error of
<emphasis remap='I'>message</emphasis>
to the status check request.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>ERROR: <emphasis remap='I'>host</emphasis> NAK: [NAK parse failed]</term>
<listitem>
<para>(error)
<emphasis remap='B'>Amcheck</emphasis>
could not parse the negative acknowledgment error from
<emphasis remap='I'>host</emphasis>.
There might be an Amanda version mismatch between the host running
<command>amcheck</command>
and
<emphasis remap='I'>host</emphasis>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>ERROR: <emphasis remap='I'>host</emphasis> [mutual-authentication failed]</term>
<listitem>
<para>(error)
Kerberos authentication failed while contacting
<emphasis remap='I'>host</emphasis>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>ERROR: <emphasis remap='I'>host</emphasis>: <emphasis remap='I'>message</emphasis></term>
<listitem>
<para>(error)
Error
<emphasis remap='I'>message</emphasis>
was reported by the status check on
<emphasis remap='I'>host</emphasis>.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1><title>EXIT CODE</title>
The exit code of <command>amcheck</command> is one of:
<programlisting>
0 = success
1 = error
</programlisting>
</refsect1>
<seealso>
<manref name="amanda.conf" vol="5"/>
<manref name="amdump" vol="8"/>
</seealso>
</refentry>