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.2
10 .TH "DISKLIST" "5" "07/25/2012" "Amanda 3\&.3\&.2" "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 contains
38 directive or disklist entry (\fBDLE\fR)\&.
40 \fBincludefile\fR \fIstring\fR
43 \fIno default\fR\&. The name of a disklist file to include within the current file\&. Useful for sharing disklist among several configurations\&. Relative pathnames are relative to the configuration directory\&.
48 usually contains one line per disk:
50 \fIhostname diskname\fR [\fIdiskdevice\fR] \fIdumptype\fR [\fIspindle\fR [\fIinterface\fR] ]
54 \fIhostname diskname\fR
57 Lines starting with # are ignored, as are blank lines\&. The fields have the following meanings:
61 The name of the host to be backed up\&. If
63 refers to a PC share, this is the host Amanda will run the Samba
65 program on to back up the share\&.
70 The name of the disk (a label)\&. In most case, you set your
74 and you don\*(Aqt set the
76 If you want multiple entries with the same
77 \fBdiskdevice\fR, you must set a different
79 for each entry\&. It\*(Aqs the
81 that you use on the commandline for any Amanda command\&. Look at the example/disklist file for example\&.
86 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
89 \fIsd0a\fR, or a mount point such as
92 It may also refer to a PC share by starting the name with two (forward) slashes, e\&.g\&.
93 //some\-pc/home\&. In this case, the
95 option in the associated
98 \fBGNUTAR\fR\&. It is the combination of the double slash disk name and
102 that triggers the use of Samba\&.
112 \fIDumptype\fRs specify backup related parameters, such as whether to compress the backups, whether to record backup results in
113 /var/lib/dumpdates, the disk\*(Aqs relative priority, etc\&.
119 \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\&.
125 \fIlocal\fR\&. The name of a network interface definition in the
127 file, used to balance network load\&.
131 \fBdumptype\fR, it is possible to define one in\-line, enclosing
133 options within curly braces, one per line, just like a
136 \fBamanda\&.conf\fR\&. Since pre\-existing
137 \fBdumptype\fRs are valid option names, this syntax may be used to customize
138 \fBdumptype\fRs for particular disks\&.
142 follow the left curly bracket\&.
148 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:
150 \fIhostname diskname\fR [ \fIdiskdevice\fR ] {
153 } [ \fIspindle\fR [ \fIinterface\fR ] ]
156 The { must appear at the end of a line, and the } on its own line possibly followed by the spindle and interface\&.
163 : http://wiki.zmanda.com/
166 \fBJames da Silva\fR <\&jds@amanda\&.org\&>
168 \fBStefan G\&. Weichinger\fR <\&sgw@amanda\&.org\&>
170 \fBDustin J\&. Mitchell\fR <\&dustin@zmanda\&.com\&>
172 Zmanda, Inc\&. (http://www\&.zmanda\&.com)