"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"

[

  %global_entities;

]>

<refentry id='amarchiver.8'>

<refmeta>

<refentrytitle>amarchiver</refentrytitle>

<manvolnum>8</manvolnum>

&rmi.source;

&rmi.version;

&rmi.manual.8;

</refmeta>

<refnamediv>

<refname>amarchiver</refname>

<refpurpose>Create, extract or list amanda archive</refpurpose>

</refnamediv>

<refentryinfo>

&author.dustin;

&author.jlm;

</refentryinfo>

<refsynopsisdiv>

<cmdsynopsis>

  <command>amarchiver</command>

    <arg choice='plain'>--version|--create|--extract|--list</arg>

    <arg choice='opt'>--verbose</arg>

    <arg choice='opt'>--file <replaceable>file</replaceable></arg>

    <arg choice='plain' rep='repeat'><arg choice='opt'><replaceable>filename</replaceable></arg></arg>

</cmdsynopsis>

</refsynopsisdiv>

<refsect1><title>DESCRIPTION</title>

<para><emphasis remap='B'>Amarchiver</emphasis> manipulates amanda archive

file.  On creation, amarchiver doesn't recurse into directories. If a filename

specifies a directory, it will be ignored.  If it specifies a character device,

amarchiver reads the device and archives the data.  If a filename specifies a

named pipe, amarchiver reads the named pipe and archives the data.</para>

<para>Note that this tool is more limited than the Amanda archive library, and

may not be appropriate for some archive files -- particularly those which use

non-strings in their filenames.</para>

</refsect1>

<refsect1><title>OPTIONS</title>

<variablelist remap='TP'>

  <varlistentry>

  <term><option>--version</option></term>

  <listitem>

<para>print the amarchiver version</para>

  </listitem>

  </varlistentry>

  <varlistentry>

  <term><option>--create</option></term>

  <listitem>

<para>Create an amanda archive. Only the supplied filenames are included.  With one <option>--verbose</option>, lists the filenames.  With two, lists the filenames and sizes.</para>

  </listitem>

  </varlistentry>

  <varlistentry>

  <term><option>--list</option></term>

  <listitem>

<para>List the filenames in an amanda archive.  No additional filenames are allowed on the command line.</para>

  </listitem>

  </varlistentry>

  <varlistentry>

  <term><option>--extract</option></term>

  <listitem>

<para>Extract an amanda archive.  If filenames are supplied, only those files are extracted.  Files are created in the current directory, suffixed with a dot ('.') and the attribute ID.</para>

  </listitem>

  </varlistentry>

  <varlistentry>

  <term><option>--verbose</option></term>

  <listitem>

<para>Give more information.</para>

  </listitem>

  </varlistentry>

  <varlistentry>

  <term><option>--file</option> file</term>

  <listitem>

<para>Create, list or extract from the given file instead of stdin/stdout.</para>

  </listitem>

  </varlistentry>

</variablelist>

</refsect1>

<seealso>

<manref name="amanda-archive-format" vol="5"/>

</seealso>

</refentry>