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