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"
5 <!-- entities files to use -->
6 <!ENTITY % global_entities SYSTEM 'global.entities'>
10 <refentry id='amarchiver.8'>
13 <refentrytitle>amarchiver</refentrytitle>
14 <manvolnum>8</manvolnum>
20 <refname>amarchiver</refname>
21 <refpurpose>Create, extract or list amanda archive</refpurpose>
27 <!-- body begins here -->
30 <command>amarchiver</command>
31 <arg choice='plain'>--version|--create|--extract|--list</arg>
32 <arg choice='opt'>--verbose</arg>
33 <arg choice='opt'>--file <replaceable>file</replaceable></arg>
34 <arg choice='plain' rep='repeat'><arg choice='opt'><replaceable>filename</replaceable></arg></arg>
38 <refsect1><title>DESCRIPTION</title>
40 <para><emphasis remap='B'>Amarchiver</emphasis> manipulates amanda archive
41 file. On creation, amarchiver doesn't recurse into directories. If a filename
42 specifies a directory, it will be ignored. If it specifies a character device,
43 amarchiver reads the device and archives the data. If a filename specifies a
44 named pipe, amarchiver reads the named pipe and archives the data.</para>
46 <para>Note that this tool is more limited than the Amanda archive library, and
47 may not be appropriate for some archive files -- particularly those which use
48 non-strings in their filenames.</para>
52 <refsect1><title>OPTIONS</title>
53 <variablelist remap='TP'>
55 <term><option>--version</option></term>
57 <para>print the amarchiver version</para>
61 <term><option>--create</option></term>
64 <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>
69 <term><option>--list</option></term>
71 <para>List the filenames in an amanda archive. No additional filenames are allowed on the command line.</para>
75 <term><option>--extract</option></term>
77 <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>
81 <term><option>--verbose</option></term>
83 <para>Give more information.</para>
87 <term><option>--file</option> file</term>
89 <para>Create, list or extract from the given file instead of stdin/stdout.</para>
96 <manref name="amanda-archive-format" vol="5"/>