"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"
[
<!-- entities files to use -->
- <!ENTITY % global_entities SYSTEM '../entities/global.entities'>
+ <!ENTITY % global_entities SYSTEM 'global.entities'>
%global_entities;
]>
</refmeta>
<refnamediv>
<refname>amrecover</refname>
-<refpurpose>&A; index database browser</refpurpose>
+<refpurpose>Amanda index database browser</refpurpose>
</refnamediv>
<refentryinfo>
&author.alan;
<refsynopsisdiv>
<cmdsynopsis>
<command>amrecover</command>
- <arg choice='opt'>-C <replaceable>config</replaceable></arg>
<arg choice='opt'>-s <replaceable>index-server</replaceable></arg>
<arg choice='opt'>-t <replaceable>tape-server</replaceable></arg>
<arg choice='opt'>-d <replaceable>tape-device</replaceable></arg>
- <arg choice='plain' rep='repeat'><group><arg choice='plain'>-o </arg><replaceable>configoption</replaceable></group></arg>
+ <arg choice='opt'>-h <replaceable>hostname</replaceable></arg>
+ &configoverride.synopsis;
+ <arg choice='opt'>-C <replaceable>config</replaceable></arg>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1><title>DESCRIPTION</title>
<para><emphasis remap='B'>Amrecover</emphasis>
-browses the database of &A; index files to determine which tapes
+browses the database of Amanda index files to determine which tapes
contain files to recover. Furthermore, it is able to recover files.</para>
<para>In order to restore files in place, you must invoke
<para>Amrecover will read the <emphasis remap='B'>amanda-client.conf</emphasis> file and the <replaceable>config</replaceable><emphasis remap='B'>/amanda-client.conf</emphasis> file. If no configuration name is supplied on the command line, Amrecover will try the compiled-in default configuration ,usually <emphasis remap='B'>DailySet1</emphasis>.</para>
<para>See the
-<citerefentry><refentrytitle>amanda</refentrytitle><manvolnum>8</manvolnum></citerefentry>
-man page for more details about &A;.</para>
+<manref name="amanda" vol="8"/>
+man page for more details about Amanda.</para>
</refsect1>
<refsect1><title>OPTIONS</title>
<varlistentry>
<term><emphasis remap='B'>[ -C ] config</emphasis></term>
<listitem>
-<para>&A; configuration.</para>
+<para>Amanda configuration.</para>
</listitem>
</varlistentry>
<varlistentry>
<para>Tape device to use on the tape server host.</para>
</listitem>
</varlistentry>
+ <varlistentry>
+ <term><option>-h hostname</option></term>
+ <listitem>
+<para>Hostname to begin restoring; defaults to the system's hostname.</para>
+ </listitem>
+ </varlistentry>
<varlistentry>
<term><emphasis remap='B'>-o</emphasis> <replaceable>clientconfigoption</replaceable></term>
<listitem>
<para>See the "<emphasis remap='B'>CONFIGURATION OVERRIDE</emphasis>"
- section in <citerefentry><refentrytitle>amanda</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
+ section in <manref name="amanda" vol="8"/>.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
+<refsect1><title>AUTH</title>
+<para>The default <emphasis remap='B'>auth</emphasis> is 'BSDTCP', you can set
+a different auth in the <emphasis remap='B'>amanda-client.conf</emphasis> file
+or by specifying the '-oauth=bsd' command line argument.</para>
+</refsect1>
+
<refsect1><title>COMMANDS</title>
<para><emphasis remap='B'>Amrecover</emphasis>
connects to the index server and then presents a command line prompt.
<listitem>
<para>List all
<emphasis remap='B'>diskname</emphasis></para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><emphasis remap='B'>listproperty</emphasis></term>
+ <listitem>
+<para>List all
+<emphasis remap='B'>property</emphasis></para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><emphasis remap='B'>setproperty</emphasis> [<emphasis remap='B'>append</emphasis>] [<emphasis remap='B'>priority</emphasis>] <emphasis remap='I'>name</emphasis> [<emphasis remap='I'>value</emphasis> ...]</term>
+ <listitem>
+<para>Set the property <emphasis remap='I'>name</emphasis> to the value <emphasis remap='I'>value</emphasis>.
+The <emphasis remap='B'>append</emphasis> keyword appends the <emphasis remap='I'>value</emphasis> to the values already set for this property.
+Without <emphasis remap='I'>value</emphasis>, the property is unset.
+The <emphasis remap='B'>priority</emphasis> keyword is unused, it is present for ease of copy/paste from application definition.</para>
</listitem>
</varlistentry>
<varlistentry>
<para>If you want amrecover to use your changer, the
<emphasis remap='I'>tapedev</emphasis>
-must be equal to the amrecover_changer setting on the server.</para>
+must be equal to the <amkeyword>amrecover-changer</amkeyword> setting on the server.</para>
<para>Since device names contain colons, you must always specify the hostname.</para>
is
<emphasis remap='B'>tar</emphasis>,
they are extracted on the local machine the same way tar volumes are extracted.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><emphasis remap='B'>settranslate</emphasis> [<emphasis remap='B'>on</emphasis>|<emphasis remap='B'>off</emphasis>]</term>
+ <listitem>
+<para>Default: on. Translate escaped octal value ('\000') in
+the index file to their corespondig characters, it improve the interface
+if amrecover is run in the same charset as the filename. Set it to
+<emphasis remap='B'>off</emphasis> if the charset of some filename is not compatible with the amrecover charset.</para>
</listitem>
</varlistentry>
<varlistentry>
<para>Display the contents of the restore list.
If a file name is specified,
the restore list is written to that file.
-This can be used to manually extract the files from the &A; tapes with
+This can be used to manually extract the files from the Amanda tapes with
<emphasis remap='B'>amrestore</emphasis>.</para>
</listitem>
</varlistentry>
syslog.7: No such file or directory
# amrecover MyConfig
AMRECOVER Version 2.4.2. Contacting server on oops ...
-220 oops &A; index server (2.4.2) ready.
+220 oops Amanda index server (2.4.2) ready.
Setting restore date to today (1997-12-09)
200 Working date set to 1997-12-09.
200 Config set to MyConfig.
<!-- .RE -->
</refsect1>
-<refsect1><title>SEE ALSO</title>
-<para><citerefentry><refentrytitle>amanda</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
-<citerefentry><refentrytitle>amanda-client.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
-<citerefentry><refentrytitle>amrestore</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
-<citerefentry><refentrytitle>amfetchdump</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
-<citerefentry><refentrytitle>readline</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
-<ulink url="http://wiki.zmanda.com"/>
-</para>
-</refsect1>
-</refentry>
+<seealso>
+<manref name="amanda-client.conf" vol="5"/>
+<manref name="amrestore" vol="8"/>
+<manref name="amfetchdump" vol="8"/>
+<manref name="readline" vol="3"/>
+</seealso>
+</refentry>