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 '../entities/global.entities'>
10 <refentry id='amstar.8'>
13 <refentrytitle>amstar</refentrytitle>
14 <manvolnum>8</manvolnum>
20 <refname>amstar</refname>
21 <refpurpose>Amanda Application to interface with star</refpurpose>
27 <!-- body begins here -->
29 <refsect1><title>DESCRIPTION</title>
31 <para>Amstar is an &A; Application API script. It should not be run
32 by users directly. It uses star to backup and restore data.</para>
36 <refsect1><title>PROPERTIES</title>
38 <para>This section lists the properties that control amstar's functionality.
39 See <citerefentry><refentrytitle>amanda-applications</refentrytitle><manvolnum>7</manvolnum></citerefentry>
40 for information on application properties and how they are configured.</para>
42 <!-- PLEASE KEEP THIS LIST IN ALPHABETICAL ORDER -->
45 <varlistentry><term>ONE-FILE-SYSTEM</term><listitem>
46 If "YES" (the default), do not allow star to cross filesystem boundaries. If "NO", star will cross filesystem boundaries. This corresponds to the <emphasis>-xdev</emphasis> option of star.
47 </listitem></varlistentry>
49 <varlistentry><term>SPARSE</term><listitem>
50 If "YES" (the default), star will store sparse files efficiently. If "NO", then the <emphasis>-sparse</emphasis> option is not given to star, and it will not try to detect sparse files.
51 </listitem></varlistentry>
53 <varlistentry><term>STAR-DLE-TARDUMP</term><listitem>
54 If "YES", amstar will use a different tardump file for each DLE. The default is "NO". This property is needed with older versions of star doing many dumps in parallel, because of a race condition in updating the tardump file.
55 </listitem></varlistentry>
57 <varlistentry><term>STAR-PATH</term><listitem>
58 The path to the star binary. The default is set when &A; is built.
59 </listitem></varlistentry>
61 <varlistentry><term>STAR-TARDUMP</term><listitem>
62 The directory where star stores the database it uses to generate incremental dumps. The default is set when &A; is built.
63 </listitem></varlistentry>
68 <refsect1><title>SEE ALSO</title>
70 <citerefentry><refentrytitle>amanda.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
71 <citerefentry><refentrytitle>amanda-applications</refentrytitle><manvolnum>7</manvolnum></citerefentry>