git.gag.com Git - debian/amanda/blob - man/xml-source/amcheckdump.8.xml

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
   3                    "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"
   4 [
   5   <!-- entities files to use -->
   6   <!ENTITY % global_entities SYSTEM 'global.entities'>
   7   %global_entities;
   8 ]>
   9
  10 <refentry id='amcheckdump.8'>
  11 <refmeta>
  12 <refentrytitle>amcheckdump</refentrytitle>
  13 <manvolnum>8</manvolnum>
  14 &rmi.source;
  15 &rmi.version;
  16 &rmi.manual.8;
  17 </refmeta>
  18 <refnamediv>
  19 <refname>amcheckdump</refname>
  20 <refpurpose>check the results of an Amanda dump</refpurpose>
  21 </refnamediv>
  22 <refentryinfo>
  23 &author.ian;
  24 </refentryinfo>
  25 <!-- body begins here -->
  26 <refsynopsisdiv>
  27 <cmdsynopsis>
  28   <command>amcheckdump</command>
  29     <arg choice='plain'><replaceable>config</replaceable></arg>
  30     <arg choice='opt'>--timestamp|-t <replaceable>timestamp</replaceable></arg>
  31     <arg choice='opt'>--verbose</arg>
  32     &configoverride.synopsis;
  33 </cmdsynopsis>
  34 </refsynopsisdiv>
  35
  36 <refsect1><title>DESCRIPTION</title>
  37
  38 <para><emphasis remap='B'>Amcheckdump</emphasis> verifies Amanda dump images by
  39 reading them from storage volume(s) and verifying that the images can be parsed
  40 by the appropriate application (if available).  For example, a GNUTAR
  41 image is passed to GNU Tar for parsing, and any errors
  42 (e.g., corrupt or missing data) are noted.</para>
  43
  44 <para>The application runs on the most recent dump or, if <emphasis
  45 remap='I'>--timestamp</emphasis> is specified, on the most recent dump with
  46 that timestamp.  Note that the verification is local to the Amanda server; if the
  47 dump application is not available, or is configured differently on the server
  48 than on the client, then the verification will most likely fail.</para>
  49
  50 <para>If a changer is available, it is used to load the required
  51 tapes.  Otherwise, the application interactively requests the tapes.</para>
  52
  53 <para>See the "<emphasis
  54 remap='B'>CONFIGURATION OVERRIDE</emphasis>" section in
  55 <manref name="amanda" vol="8"/>
  56 for information on the <literal>-o</literal> option.</para>
  57 </refsect1>
  58
  59 <refsect1><title>EXAMPLE</title>
  60 <para><programlisting>
  61 # check the most recent dump
  62 amcheckdump MYCONFIG
  63
  64 # check a specific dump from back in '78
  65 amcheckdump MYCONFIG --timestamp 19780615
  66 </programlisting></para>
  67 </refsect1>
  68
  69 <seealso>
  70 <manref name="amcheck" vol="8" />
  71 </seealso>
  72
  73 </refentry>