3 .\" Author: James da Silva <jds@amanda.org>
4 .\" Generator: DocBook XSL Stylesheets vsnapshot_8273 <http://docbook.sf.net/>
6 .\" Manual: File formats and conventions
7 .\" Source: Amanda 2.6.1p2
10 .TH "DISKLIST" "5" "11/05/2009" "Amanda 2\&.6\&.1p2" "File formats and conventions"
11 .\" -----------------------------------------------------------------
12 .\" * set default formatting
13 .\" -----------------------------------------------------------------
14 .\" disable hyphenation
16 .\" disable justification (adjust text to left margin only)
18 .\" -----------------------------------------------------------------
19 .\" * MAIN CONTENT STARTS HERE *
20 .\" -----------------------------------------------------------------
22 disklist \- List of partitions to back up for \fIAmanda\fR
27 file determines which disks will be backed up by
28 \fIAmanda\fR\&. The file usually contains one line per disk:
30 \fIhostname diskname\fR [\fIdiskdevice\fR] \fIdumptype\fR [\fIspindle\fR [\fIinterface\fR] ]
34 \fIhostname diskname\fR
37 Lines starting with # are ignored, as are blank lines\&. The fields have the following meanings:
41 The name of the host to be backed up\&. If
43 refers to a PC share, this is the host
47 program on to back up the share\&.
52 The name of the disk (a label)\&. In most case, you set your
56 and you don\'t set the
58 If you want multiple entries with the same
59 \fBdiskdevice\fR, you must set a different
61 for each entry\&. It\'s the
63 that you use on the commandline for any
65 command\&. Look at the example/disklist file for example\&.
70 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
73 \fIsd0a\fR, or a mount point such as
76 It may also refer to a PC share by starting the name with two (forward) slashes, e\&.g\&.
77 //some\-pc/home\&. In this case, the
79 option in the associated
82 \fBGNUTAR\fR\&. It is the combination of the double slash disk name and
86 that triggers the use of Samba\&.
96 \fIDumptype\fRs specify backup related parameters, such as whether to compress the backups, whether to record backup results in
97 /etc/dumpdates, the disk\'s relative priority, etc\&.
103 \fB\-1\fR\&. A number used to balance backup load on a host\&.
105 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\&.
111 \fIlocal\fR\&. The name of a network interface definition in the
113 file, used to balance network load\&.
117 \fBdumptype\fR, it is possible to define one in\-line, enclosing
119 options within curly braces, one per line, just like a
122 \fBamanda\&.conf\fR\&. Since pre\-existing
123 \fBdumptype\fRs are valid option names, this syntax may be used to customize
124 \fBdumptype\fRs for particular disks\&.
128 follow the left curly bracket\&.
134 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:
136 \fIhostname diskname\fR [ \fIdiskdevice\fR ] {
139 } [ \fIspindle\fR [ \fIinterface\fR ] ]
143 \fBJames da Silva\fR <\&jds@amanda\&.org\&>
145 \fBStefan G\&. Weichinger\fR <\&sgw@amanda\&.org\&>
147 \fBDustin J\&. Mitchell\fR <\&dustin@zmanda\&.com\&>
149 Zmanda, Inc\&. (http://www\&.zmanda\&.com)