3 .\" Author: James da Silva <jds@amanda.org>
4 .\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
6 .\" Manual: File formats and conventions
7 .\" Source: Amanda 3.3.1
10 .TH "DISKLIST" "5" "02/21/2012" "Amanda 3\&.3\&.1" "File formats and conventions"
11 .\" -----------------------------------------------------------------
12 .\" * Define some portability stuff
13 .\" -----------------------------------------------------------------
14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15 .\" http://bugs.debian.org/507673
16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
20 .\" -----------------------------------------------------------------
21 .\" * set default formatting
22 .\" -----------------------------------------------------------------
23 .\" disable hyphenation
25 .\" disable justification (adjust text to left margin only)
27 .\" -----------------------------------------------------------------
28 .\" * MAIN CONTENT STARTS HERE *
29 .\" -----------------------------------------------------------------
31 disklist \- List of partitions to back up for Amanda
36 file determines which disks will be backed up by Amanda\&. The file usually contains one line per disk:
38 \fIhostname diskname\fR [\fIdiskdevice\fR] \fIdumptype\fR [\fIspindle\fR [\fIinterface\fR] ]
42 \fIhostname diskname\fR
45 Lines starting with # are ignored, as are blank lines\&. The fields have the following meanings:
49 The name of the host to be backed up\&. If
51 refers to a PC share, this is the host Amanda will run the Samba
53 program on to back up the share\&.
58 The name of the disk (a label)\&. In most case, you set your
62 and you don\*(Aqt set the
64 If you want multiple entries with the same
65 \fBdiskdevice\fR, you must set a different
67 for each entry\&. It\*(Aqs the
69 that you use on the commandline for any Amanda command\&. Look at the example/disklist file for example\&.
74 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
77 \fIsd0a\fR, or a mount point such as
80 It may also refer to a PC share by starting the name with two (forward) slashes, e\&.g\&.
81 //some\-pc/home\&. In this case, the
83 option in the associated
86 \fBGNUTAR\fR\&. It is the combination of the double slash disk name and
90 that triggers the use of Samba\&.
100 \fIDumptype\fRs specify backup related parameters, such as whether to compress the backups, whether to record backup results in
101 /var/lib/dumpdates, the disk\*(Aqs relative priority, etc\&.
107 \fB\-1\fR\&. A number used to balance backup load on a host\&. Amanda 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\&.
113 \fIlocal\fR\&. The name of a network interface definition in the
115 file, used to balance network load\&.
119 \fBdumptype\fR, it is possible to define one in\-line, enclosing
121 options within curly braces, one per line, just like a
124 \fBamanda\&.conf\fR\&. Since pre\-existing
125 \fBdumptype\fRs are valid option names, this syntax may be used to customize
126 \fBdumptype\fRs for particular disks\&.
130 follow the left curly bracket\&.
136 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:
138 \fIhostname diskname\fR [ \fIdiskdevice\fR ] {
141 } [ \fIspindle\fR [ \fIinterface\fR ] ]
144 The { must appear at the end of a line, and the } on its own line possibly followed by the spindle and interface\&.
151 : http://wiki.zmanda.com/
154 \fBJames da Silva\fR <\&jds@amanda\&.org\&>
156 \fBStefan G\&. Weichinger\fR <\&sgw@amanda\&.org\&>
158 \fBDustin J\&. Mitchell\fR <\&dustin@zmanda\&.com\&>
160 Zmanda, Inc\&. (http://www\&.zmanda\&.com)