-<refsect1><title>DISKLIST FILE</title>
-<para>The
-<emphasis remap='I'>disklist</emphasis>
-file determines which disks will be backed up by &A;.
-The file usually contains one line per disk:</para>
-
-<programlisting>
-<emphasis>hostname diskname</emphasis> [<emphasis>diskdevice</emphasis>] <emphasis>dumptype</emphasis> [<emphasis>spindle</emphasis> [<emphasis>interface</emphasis>] ]
-</programlisting>
-
-<para>All pairs [ <emphasis>hostname diskname</emphasis> ] must be unique.</para>
-
-<para>Lines starting with # are ignored, as are blank lines.
-The fields have the following meanings:</para>
-<variablelist remap='TP'>
- <varlistentry>
- <term><emphasis remap='I'>hostname</emphasis></term>
- <listitem>
-<para>The name of the host to be backed up.
-If
-<emphasis remap='B'>diskdevice</emphasis>
-refers to a PC share, this is the host &A; will run the Samba
-<emphasis remap='B'>smbclient</emphasis> program on to back up the share.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><emphasis remap='I'>diskname</emphasis></term>
- <listitem>
-<para>The name of the disk (a label).
-In most case, you set your
-<emphasis remap='B'>diskname</emphasis>
-to the
-<emphasis remap='B'>diskdevice</emphasis>
-and you don't set the
-<emphasis remap='B'>diskdevice.</emphasis>
-If you want multiple entries with the same
-<emphasis remap='B'>diskdevice</emphasis>,
-you must set a different
-<emphasis remap='B'>diskname</emphasis>
-for each entry. It's the
-<emphasis remap='B'>diskname</emphasis>
-that you use on the commandline for any &A; command.
-Look at the example/disklist file for example.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><emphasis remap='I'>diskdevice</emphasis></term>
- <listitem>
-<para>Default: same as diskname.
-The name of the disk device to be backed up. It may be a full device name,
-a device name without the
-<filename>/dev/</filename>
-prefix, e.g.
-<emphasis remap='I'>sd0a</emphasis>,
-or a mount point such as
-<filename>/usr</filename>.</para>
-
-<para>It may also refer to a PC share by starting the name with two (forward) slashes, e.g.
-<filename>//some-pc/home</filename>.
-In this case, the
-<emphasis remap='B'>program</emphasis>
-option in the associated
-<emphasis remap='B'>dumptype</emphasis>
-must be entered as
-<emphasis remap='B'>GNUTAR</emphasis>.
-It is the combination of the double slash disk name and
-<emphasis remap='B'>program GNUTAR</emphasis>
-in the
-<emphasis remap='B'>dumptype</emphasis>
-that triggers the use of Samba.</para>
-</listitem>
-</varlistentry>
-
- <varlistentry>
- <term><emphasis remap='I'>dumptype</emphasis></term>
- <listitem>
-<para>Refers to a
-<emphasis remap='B'>dumptype</emphasis>
-defined in the
-<emphasis remap='B'>amanda.conf</emphasis>
-file.
-<emphasis remap='I'>Dumptype</emphasis>s
-specify backup related parameters,
-such as whether to compress the backups,
-whether to record backup results in
-<filename>/etc/dumpdates</filename>, the disk's relative priority, etc.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><emphasis remap='I'>spindle</emphasis></term>
- <listitem>
-<para>Default:
-<option>-1</option>.
-A number used to balance backup load on a host.
-&A; will not run multiple backups at the same time
-on the same spindle, unless the spindle number is -1,
-which means there is no spindle restriction.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><emphasis remap='I'>interface</emphasis></term>
- <listitem>
-<para>Default:
-<emphasis remap='I'>local</emphasis>.
-The name of a network interface definition in the
-<emphasis remap='B'>amanda.conf</emphasis>
-file, used to balance network load.</para>
- </listitem>
- </varlistentry>
-</variablelist>
-
-<para>Instead of naming a
-<emphasis remap='B'>dumptype</emphasis>,
-it is possible to define one in-line, enclosing
-<emphasis remap='B'>dumptype</emphasis>
-options within curly braces, one per line, just like a
-<emphasis remap='B'>dumptype</emphasis>
-definition in
-<emphasis remap='B'>amanda.conf</emphasis>.
-Since pre-existing
-<emphasis remap='B'>dumptype</emphasis>s
-are valid option names, this syntax may be used to customize
-<emphasis remap='B'>dumptype</emphasis>s
-for particular disks.</para>
-
-<para>A line break
-<emphasis remap='B'>must</emphasis>
-follow the left curly bracket.</para>
-
-<para>For instance, if a
-<emphasis remap='B'>dumptype</emphasis>
-named
-<emphasis remap='I'>normal</emphasis>
-is used for most disks, but use of the holding disk needs to be disabled
-for the file system that holds it, this would work instead of defining
-a new dumptype:</para>
-
-<programlisting>
-<emphasis remap='I'>hostname diskname</emphasis> [ <emphasis remap='I'>diskdevice</emphasis> ] {
- normal
- holdingdisk never
-} [ <emphasis remap='I'>spindle</emphasis> [ <emphasis remap='I'>interface</emphasis> ] ]
-</programlisting>
-
-</refsect1>
-
-<refsect1><title>TAPE MANAGEMENT</title>
-<para>The
-<emphasis remap='I'>tapelist</emphasis>
-file contains the list of tapes in active use.
-This file is maintained entirely by &A; and should not be created
-or edited during normal operation.
-It contains lines of the form:</para>
-
-<para><programlisting>YYYYMMDD label flags
-</programlisting></para>
-
-<para>Where
-<emphasis remap='I'>YYYYMMDD</emphasis>
-is the date the tape was written,
-<emphasis remap='I'>label</emphasis>
-is a label for the tape as written by
-<emphasis remap='B'>amlabel</emphasis>
-and
-<emphasis remap='I'>flags</emphasis>
-tell &A; whether the tape may be reused, etc (see the
-<emphasis remap='B'>reuse</emphasis>
-options of
-<emphasis remap='B'>amadmin</emphasis>).</para>
-
-<para><emphasis remap='B'>Amdump</emphasis>
-and
-<emphasis remap='B'>amflush</emphasis>
-will refuse to write to an unlabeled tape, or to a labeled tape that is considered active.
-There must be more tapes in active rotation (see the
-<emphasis remap='B'>tapecycle</emphasis>
-option) than there are runs in the backup cycle (see the
-<emphasis remap='B'>dumpcycle</emphasis>
-option) to prevent overwriting a backup image that would be needed to do a full recovery.</para>
-</refsect1>
-
-<refsect1 id='output_drivers'><title>OUTPUT DRIVERS</title>
-<para>The normal value for the
-<emphasis remap='B'>tapedev</emphasis>
-parameter, or for what a tape changer returns,
-is a full path name to a non-rewinding tape device, such as
-<filename>/dev/nst0</filename>
-or
-<filename>/dev/rmt/0mn</filename>
-or
-<filename>/dev/nst0.1</filename>
-or whatever conventions the operating system uses. &A; provides additional application level drivers that
-support non-traditional tape-simulations or features. To access a specific output driver, set
-<emphasis remap='B'>tapedev</emphasis>
-(or configure your changer to return) a string of the form
-<emphasis remap='I'>driver</emphasis>:<emphasis remap='I'>driver-info</emphasis>
-where
-<emphasis remap='I'>driver</emphasis>
-is one of the supported drivers and
-<emphasis remap='I'>driver-info</emphasis>
-is optional additional information needed by the driver.</para>
-
-<para>The supported drivers are:</para>
-<variablelist remap='TP'>
- <varlistentry>
- <term><emphasis remap='I'>tape</emphasis></term>
- <listitem>
-<para>This is the default driver.
-The
-<emphasis remap='I'>driver-info</emphasis>
-is the tape device name.
-Entering
-<programlisting>tapedev /dev/rmt/0mn
-</programlisting>
-is really a short hand for
-<programlisting>tapedev tape:/dev/rmt/0mn
-</programlisting></para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><emphasis remap='I'>null</emphasis></term>
- <listitem>
-<para>This driver throws away anything written to it and returns EOF
-for any reads except a special case is made for reading a label,
-in which case a "fake" value is returned that &A; checks for
-and allows through regardless of what you have set in
-<emphasis remap='B'>labelstr</emphasis>.
-The
-<emphasis remap='I'>driver-info</emphasis>
-field is not used and may be left blank:</para>
-
-<para><programlisting>tapedev null:
-</programlisting></para>
-
-<para>The <emphasis remap='I'>length</emphasis>
-value from the associated
-<emphasis remap='B'>tapetype</emphasis>
-is used to limit the amount of data written. When the limit is reached, the driver will simulate end of tape.</para>
-
-<note><para>This driver should only be used for debugging and testing,
-and probably only with the
-<emphasis remap='B'>record</emphasis>
-option set to
-<emphasis remap='I'>no</emphasis>.
-</para>
-</note>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><emphasis remap='I'>rait</emphasis></term>
- <listitem>
-<para><emphasis remap='I'>R</emphasis>edundant
-<emphasis remap='I'>A</emphasis>rray
-of
-<emphasis remap='I'>I</emphasis>nexpensive (?)
-<emphasis remap='I'>T</emphasis>apes.
-Reads and writes tapes mounted on multiple drives by spreading
-the data across N-1 drives and using the last drive for a checksum.
-See docs/RAIT for more information.</para>
-
-<para>The
-<emphasis remap='I'>driver-info</emphasis>
-field describes the devices to use. Curly braces indicate multiple replacements in the string.
-For instance:</para>
-
-<para><programlisting>tapedev rait:/dev/rmt/tps0d{4,5,6}n
-</programlisting></para>
-
-<para>would use the following devices:</para>