git.gag.com Git - debian/amanda/blob - man/xml-source/amverify.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 <!-- lifted from troff+man by doclifter -->
  11 <refentry id='amverify.8'>
  12
  13 <refmeta>
  14 <refentrytitle>amverify</refentrytitle>
  15 <manvolnum>8</manvolnum>
  16 </refmeta>
  17 <refnamediv>
  18 <refname>amverify</refname>
  19 <refpurpose>check an Amanda tape for errors</refpurpose>
  20 </refnamediv>
  21 <!-- body begins here -->
  22 <refsynopsisdiv>
  23 <cmdsynopsis>
  24   <command>amverify</command>
  25     <arg choice='plain'><replaceable>config</replaceable></arg>
  26     <arg choice='opt'><arg choice='plain'><replaceable>slot</replaceable></arg><arg choice='opt'><replaceable>runtapes</replaceable></arg></arg>
  27 </cmdsynopsis>
  28 </refsynopsisdiv>
  29
  30
  31 <refsect1><title>DESCRIPTION</title>
  32 <para><emphasis remap='B'>Amverify</emphasis>
  33 reads an Amanda format tape and makes sure each backup image
  34 can be processed by
  35 <emphasis remap='B'>amrestore</emphasis>
  36 and, if possible, the appropriate restore program (e.g.
  37 <emphasis remap='B'>tar</emphasis>).</para>
  38
  39 <para><emphasis remap='B'>Amverify</emphasis>
  40 runs
  41 <emphasis remap='B'>amrestore</emphasis>
  42 on each file of the tape and pipes the output
  43 to a restore program (if available) with an option to create a catalogue
  44 of the backup.
  45 The catalogue itself is discarded.
  46 Only the success or failure of the operation itself is reported.</para>
  47
  48 <para>If the backup image cannot be processed by the restore program,
  49 e.g. if it was written on a different operating system,
  50 the image is sent through
  51 <emphasis remap='B'>dd</emphasis>
  52 to /dev/null.
  53 This still determines if the tape is readable,
  54 but does not do any internal consistency check on the image.</para>
  55
  56 <para>If
  57 <emphasis remap='I'>config</emphasis>
  58 is set up to use a tape changer,
  59 the
  60 <emphasis remap='I'>slot</emphasis>
  61 argument may be used to choose the first tape to process.
  62 Otherwise,
  63 the
  64 <emphasis remap='B'>current</emphasis>
  65 slot is used.</para>
  66
  67 <para>The
  68 <emphasis remap='B'>runtapes</emphasis>
  69 configuration parameter determines how many tapes are processed unless
  70 it is specified on the command line.</para>
  71
  72 <para>See the
  73 <citerefentry><refentrytitle>amanda</refentrytitle><manvolnum>8</manvolnum></citerefentry>
  74 man page for more details about Amanda.</para>
  75 </refsect1>
  76
  77 <refsect1><title>AUTHOR</title>
  78 <para>Axel Zinser <email>fifi@icem.de</email> : Original text</para>
  79 <para>&maintainer.sgw;: XML-conversion</para>
  80 </refsect1>
  81
  82 <refsect1><title>SEE ALSO</title>
  83 <para><citerefentry><refentrytitle>amrestore</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
  84 <citerefentry><refentrytitle>amanda</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
  85 <citerefentry><refentrytitle>amverifyrun</refentrytitle><manvolnum>8</manvolnum></citerefentry></para>
  86 </refsect1>
  87 </refentry>
  88