3 .\" Author: Jean-Louis Martineau <martineau@zmanda.com>
4 .\" Generator: DocBook XSL Stylesheets vsnapshot_8273 <http://docbook.sf.net/>
6 .\" Manual: System Administration Commands
7 .\" Source: Amanda 2.6.1p1
10 .TH "AMGTAR" "8" "04/10/2009" "Amanda 2\&.6\&.1p1" "System Administration Commands"
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 amgtar \- Amanda Application to interface with GNU Tar
27 Application API script\&. It should not be run by users directly\&. It uses GNU Tar to backup and restore data\&.
30 This section lists the properties that control amgtar\'s functionality\&. See
31 \fBamanda-applications\fR(7)
32 for information on application properties and how they are configured\&.
37 If "YES" (the default), amgtar use the \fI\-\-atime\-preserve=system\fR option of gnutar to not update the atime of all files accessed; if "NO", gnutar will updates the atime for all files accessed\&. This property works only if you have gnutar 1\&.15\&.90 or newer, if not, you must set ATIME_PRESERVE to "NO"\&.
43 If "YES" (the default), amgtar checks that the device number doesn\'t change for each file\&. If "NO", changes in device number are ignored\&. To ignore device numbers, tar must support the \fI\-\-no\-check\-device\fR option (gnutar 1\&.19\&.90 and newer)\&. This option is needed for some filesystems and devices on which device numbers change frequently, such as LVM or FiberChannel\&.
49 If set, gnutar will backup from that directory instead of the \fIdiskdevice\fR set by the DLE\&.
55 The directory where gnutar stores the database it uses to generate incremental dumps\&. The default is set when \fIAmanda\fR is built\&.
61 The path to the gnutar binary\&. The default is set when \fIAmanda\fR is built\&.
67 If "YES" (the default), do not allow gnutar to cross filesystem boundaries\&. If "NO", gnutar will cross filesystem boundaries\&. This corresponds to the \fI\-\-one\-filesystem\fR option of gnutar\&.
73 Block size of Nx512 bytes (default N=20)\&. This corresponds to the \fI\-\-blocking\-factor\fR option of gnutar\&.
79 If "YES" (the default), gnutar will store sparse files efficiently\&. If "NO", then the \fI\-\-sparse\fR option is not given to gnutar, and it will not try to detect sparse files\&.
85 List which exit status of gtar are good or bad\&. eg\&. "1=GOOD 2=BAD", exit status of 1 will produce a good backup, exit status of 2 will give an error\&.
91 List all regex (POSIX Extended Regular Expression syntax) that are normal output from gtar\&. These output are in the "FAILED DUMP DETAILS" section of the email report if the dump result is STRANGE or FAILED\&. Default values:
93 "^could not open conf file"
97 ": File \&.* shrunk by [0\-9][0\-9]* bytes, padding with zeros"
98 ": Cannot add file \&.*: No such file or directory$"
99 ": Error exit delayed from previous errors"
101 To treat one of these default patterns differently, specify it explicitly in a different property\&.
107 List all regex (POSIX Extended Regular Expression syntax) that amanda ignore\&. These output are never in the email report\&. Default values:
109 ": Directory is new$"
110 ": Directory has been renamed"
112 To treat one of these default patterns differently, specify it explicitly in a different property\&.
118 List all regex (POSIX Extended Regular Expression syntax) that are strange output from gtar\&. All gtar output that doesn\'t match a normal or ignore regex are strange by default\&. The result of the dump is STRANGE if gtar produce a strange output\&. These output are in the "FAILED DUMP DETAILS" section of the email report\&.
122 define application\-tool app_amgtar {
123 property "ATIME\-PRESERVE" "NO"
124 property "CHECK\-DEVICE" "YES"
125 property "GNUTAR\-LISTDIR" "
126 property "GNUTAR\-PATH" "/bin/tar"
127 property "ONE\-FILE\-SYSTEM" "YES"
128 property "TAR_BLOCKSIZE" "20"
129 property "SPARSE" "YES"
130 property "EXIT\-HANDLING" "1=GOOD 2=BAD"
131 # change a default NORMAL regex to a STRANGE regex\&.
132 property "STRANGE" ": socket ignored$"
133 # add three new IGNORE regex
134 property "IGNORE" ": Directory is new$"
135 property append "IGNORE" ": Directory has been renamed"
136 property append "IGNORE" "file changed as we read it$"
142 \fBamanda.conf\fR(5),
143 \fBamanda-applications\fR(7)
146 \fBJean\-Louis Martineau\fR <\&martineau@zmanda\&.com\&>
148 Zmanda, Inc\&. (http://www\&.zmanda\&.com)
151 \fBDustin J\&. Mitchell\fR <\&dustin@zmanda\&.com\&>
153 Zmanda, Inc\&. (http://www\&.zmanda\&.com)