"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>
<refentrytitle>amtoc</refentrytitle>
<manvolnum>8</manvolnum>
+&rmi.source;
+&rmi.version;
+&rmi.manual.8;
</refmeta>
<refnamediv>
<refname>amtoc</refname>
-<refpurpose>generate TOC (Table Of Contents) for an &A; run</refpurpose>
+<refpurpose>generate TOC (Table Of Contents) for an Amanda run</refpurpose>
</refnamediv>
+<refentryinfo>
+&author.nm;
+&author.sgw.xml;
+</refentryinfo>
<!-- body begins here -->
<refsynopsisdiv>
<cmdsynopsis>
<refsect1><title>DESCRIPTION</title>
<para><emphasis remap='I'>Amtoc</emphasis>
-generates a table of contents for an &A; run.
+generates a table of contents for an Amanda run.
It's a perl script (if you don't have perl, install it first!).</para>
</refsect1>
<refsect1><title>OUTPUT FORMAT</title>
<para>The standard output has five fields separated by two spaces:</para>
-<!-- .RS -->
-<literallayout remap='.nf'>
+<programlisting>
# Server:/partition date level size[Kb]
0 daily-05: 19991005 - -
1 cuisun15:/cuisun15/home 19991005 1 96
...
103 cuisg11:/ 19991005 0 4139136
103 total: - - 16716288
-<!-- .RE -->
-
-</literallayout><para>In tabular format (-t), this would look like:</para>
+</programlisting>
+<para>In tabular format (-t), this would look like:</para>
-<!-- .RS -->
-<literallayout remap='.nf'>
+<programlisting>
# Server:/partition date lev size[Kb]
0 daily-05: 19991005 - -
1 cuisun15:/cuisun15/home 19991005 1 96
...
103 cuisg11:/ 19991005 0 4139136
103 total: - - 16716288
-<!-- .RE -->
-</literallayout></refsect1>
+</programlisting></refsect1>
<refsect1><title>USAGE</title>
<para>The easiest way to use it is to run
<emphasis remap='I'>cron job:</emphasis></para>
<!-- .RS -->
-<literallayout remap='.nf'>
+<programlisting>
amdump daily ; logdir=`amgetconf daily logdir` ; log=`ls -1t $logdir/log.*.[0-9] | head -1` ; amtoc -a $log
-</literallayout> <!-- .fi -->
+</programlisting>
<para>which will generate /usr/local/etc/amanda//daily/<emphasis remap='I'>tape_label</emphasis>.toc.
You may also want to call
<emphasis remap='I'>amflush</emphasis>.</para>
</refsect1>
-<refsect1><title>SEE ALSO</title>
-<para><citerefentry><refentrytitle>amanda</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
-<citerefentry><refentrytitle>amdump</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
-<citerefentry><refentrytitle>amflush</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
-<citerefentry><refentrytitle>amgetconf</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
-cron,
-perl,
-<citerefentry><refentrytitle>http://wiki.zmanda.com</refentrytitle></citerefentry>
-</para>
-</refsect1>
+<seealso>
+<manref name="amdump" vol="8"/>,
+<manref name="amflush" vol="8"/>,
+<manref name="amgetconf" vol="8"/>
+</seealso>
+
-<refsect1><title>AUTHOR</title>
-<para>Nicolas Mayencourt <email>Nicolas.Mayencourt@cui.unige.ch</email>, University of Geneva/Switzerland : Original text</para>
-<para>&maintainer.sgw;: XML-conversion</para>
-</refsect1>
</refentry>