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 '../entities/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 &A; 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='plain' rep='repeat'><group><arg choice='plain'>-o </arg><replaceable>configoption</replaceable></group></arg>
  32 </cmdsynopsis>
  33 </refsynopsisdiv>
  34
  35 <refsect1><title>DESCRIPTION</title>
  36
  37 <para><emphasis remap='B'>Amcheckdump</emphasis> verifies &A; dump images by
  38 reading them from storage volume(s) and verifying that the images can be parsed
  39 by the appropriate application (if available).  For example, a GNUTAR
  40 image is passed to GNU Tar for parsing, and any errors
  41 (e.g., corrupt or missing data) are noted.</para>
  42
  43 <para>The application runs on the most recent dump or, if <emphasis
  44 remap='I'>--timestamp</emphasis> is specified, on the most recent dump with
  45 that timestamp.  Note that the verification is local to the &A; server; if the
  46 dump application is not available, or is configured differently on the server
  47 than on the client, then the verification will most likely fail.</para>
  48
  49 <para>If a changer is available, it is used to load the required
  50 tapes.  Otherwise, the application interactively requests the tapes.</para>
  51
  52 <para>See the "<emphasis
  53 remap='B'>CONFIGURATION OVERRIDE</emphasis>" section in
  54 <citerefentry><refentrytitle>amanda</refentrytitle><manvolnum>8</manvolnum></citerefentry>
  55 for information on the <literal>-o</literal> option.</para>
  56 </refsect1>
  57
  58 <refsect1><title>EXAMPLE</title>
  59 <para><programlisting>
  60 # check the most recent dump
  61 amcheckdump MYCONFIG
  62
  63 # check a specific dump from back in '78
  64 amcheckdump MYCONFIG --timestamp 19780615
  65 </programlisting></para>
  66 </refsect1>
  67  <refsect1><title>SEE ALSO</title>
  68  <para><citerefentry><refentrytitle>amanda</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
  69  <ulink url="http://wiki.zmanda.com"/>
  70  </para>
  71  </refsect1>
  72
  73 </refentry>