X-Git-Url: https://git.gag.com/?p=debian%2Famanda;a=blobdiff_plain;f=man%2Fxml-source%2Famanda.8.xml;h=7162c175c1f38bc9a7df8235a772421e87e9695b;hp=1337822e33273c5e35134ff90afe509d530e046e;hb=b116e9366c7b2ea2c2eb53b0a13df4090e176235;hpb=fd48f3e498442f0cbff5f3606c7c403d0566150e
diff --git a/man/xml-source/amanda.8.xml b/man/xml-source/amanda.8.xml
index 1337822..7162c17 100644
--- a/man/xml-source/amanda.8.xml
+++ b/man/xml-source/amanda.8.xml
@@ -205,6 +205,9 @@ configuration files for quick reference.
,
+,
+
+
,
@@ -214,7 +217,7 @@ configuration files for quick reference.
-CONFIGURATION
+CONFIGURATION FILES
There are four user-editable files that control the behavior of Amanda.
@@ -251,371 +254,7 @@ populate and maintain these directories.
the current directory is used. This feature is present for backward
compatibility, but is not commonly used.
-
-
-LOG FILES
-All log and database files generated by Amanda go in corresponding
-directories somewhere.
-The exact location is controlled by entries in
-.
-A typical location would be under /var/adm/amanda.
-For the above example, the files might go in
-/var/adm/amanda/normal/ and
-/var/adm/amanda/archive/.
-
-
-As log files are no longer needed (no longer contain relevant information),
-Amanda cycles them out in various ways, depending on the type of file.
-
-Detailed information about
-amdump
-runs are stored in dump logs -- files named
-amdump.NN
-where
-NN
-is a sequence number, with 1 being the most recent file.
-Amdump
-rotates these files each run, keeping roughly the last
-tapecycle
-(see below)
-worth of them.
-
-The file used by
-amreport
-to generate the mail summary is the trace log. This file constitutes the "catalog"
-describing the data on the tapes written in a run. It is named
-log.YYYYMMDDHHMMSS.NN
-where
-YYYYMMDDHHMMSS
-is the datestamp of the start of the
-amdump or amflush
-run and
-NN
-is a sequence number started at 0.
-At the end of each
-amdump
-run,
-log files for runs whose tapes have been reused are renamed
-into a subdirectory of the main log directory (see the
-logdir
-parameter below)
-named
-oldlog.
-It is up to the Amanda administrator to remove them from this
-directory when desired.
-
-Index (backup image catalogue) files older than the full dump
-matching the oldest backup image for a given client and disk
-are removed by
-amdump
-at the end of each run.
-
-
-
-Using Samba
-For Samba access, Amanda needs a file on the Samba server (which may
-or may not also be the tape server) named
-/etc/amandapass
-with share names, (clear text) passwords and (optional) domain names,
-in that order, one per line, whitespace separated.
-By default, the user used to connect to the PC is the same for all
-PC's and is compiled into Amanda.
-It may be changed on a host by host basis
-by listing it first in the password field followed
-by a percent sign and then the password.
-For instance:
-
- //some-pc/home normalpw
- //another-pc/disk otheruser%otherpw
-
-With clear text passwords, this file should obviously be tightly protected.
-It only needs to be readable by the Amanda-user on the Samba server.
-
-
-HOST & DISK EXPRESSION
-All host and disk arguments to programs are special expressions.
-The command applies to all DLEs that match the arguments.
-This section describes the matcher.
-
-The matcher matches by word, each word is a glob expression, words
-are separated by the separator '.' for host and '/' for disk. You
-can anchor the expression at left with a '^'. You can
-anchor the expression at right with a '$'. The matcher
-is case insensitive for host but is case sensitive for disk. A match
-succeeds if all words in your expression match contiguous words in
-the host or disk.
-
-If the disk is a UNC ("\\windows\share") then all '\' are converted to '/' before the match. Using '\' is complicated because of the extra quoting required by the shell and amanda. It's easier to use '/' because it require less quoting ("//windows/share")
-
-
-
-
- dot (.)
- word separator for a host
-
-
-
- /
- word separator for a disk
-
-
-
- \
- word separator for a UNC disk
-
-
-
- ^
- anchor at left
-
-
-
- $
- anchor at right
-
-
-
- ?
- match exactly one character except the separator
-
-
-
- *
- match zero or more characters except the separator
-
-
-
- **
- match zero or more characters including the separator
-
-
-
- [...]
- match a single character, namely any of the characters
- enclosed by the brackets.
-
-
-
- [!...]
- match a single character, namely any characters that is not
- enclosed by the brackets.
-
-
-
-
-The shell interpret some of these characters, they must be escaped by a backslash '\' and/or the expression must be enclosed in simple or double quote.
-
-Some examples:
-
-
-
- hosta
-
- Will match hosta, foo.hosta.org, and
- hoSTA.dOMAIna.ORG but not hostb.
-
-
-
-
- host
-
- Will match host but not hosta.
-
-
-
-
- host?
-
- Will match hosta and hostb, but
- not host.
-
-
-
-
- ho*na
-
- Will match hoina
- but not ho.aina.org.
-
-
-
-
- ho**na
-
- Will match hoina
- and ho.aina.org.
-
-
-
-
- ^hosta
-
- Will match hosta
- but not foo.hosta.org.
-
-
-
-
- sda*
-
- Will match /dev/sda1
- and /dev/sda12.
-
-
-
-
- /opt
-
- Will match the disk opt
- but not the host opt.
-
-
-
-
- (note dots:) .opt.
-
- Will match the host opt
- but not the disk opt.
-
-
-
-
- /
-
- Will match the disk /
- but no other disk.
-
-
-
-
- /usr
-
- Will match the disks /usr
- and /usr/local.
-
-
-
-
- /usr$
-
- Will match the disks /usr
- but not /usr/local.
-
-
-
-
- share
-
- Will match the disks \\windows1\share and \\windows2\share.
-
-
-
-
- share*
-
- Will match the disks \\windows\share1 and \\windows\share2.
-
-
-
-
- //windows/share
-
- Will match the disk \\windows\share.
-
-
-
-
-
-
-
-
-DATESTAMP EXPRESSION
-A
-datestamp
-expression is a range expression where we only match the prefix.
-Leading ^ is removed. Trailing $ forces an exact match.
-
-
-
-
- 20001212-14
- match all dates beginning with 20001212, 20001213 or 20001214
-
-
-
- 20001212-4
- same as previous
-
-
-
- 20001212-24
- match all dates between 20001212 and 20001224
-
-
-
- 2000121
- match all dates that start with 2000121 (20001210-20001219)
-
-
-
- 2
- match all dates that start with 2 (20000101-29991231)
-
-
-
- 2000-10
- match all dates between 20000101-20101231
-
-
-
- 200010$
- match only 200010
-
-
-
-
-
-
-DUMP SPECIFICATIONS A dump
-specification selects one or more dumps. It has the form [host][:disk][@datestamp], where each component
-is a pattern as described above. If a component is missing, it
-is treated as a wildcard. The characters ':', '@', and '\' may be
-escaped within any component by preceding them with a '\'.
-
-Some examples:
-
-
-
- client17
- all dumps of client17
-
-
-
- @20080615
- All dumps on with datestamps matching 20080615
-
-
-
- webserver:/var/www
- All dumps of /var/www on host webserver
-
-
-
- webserver:/var/www@200806150317
- The dump of webserver with datestamp 200806150317
-
-
-
- :/var/www
- All dumps of /var/www on any host
-
-
-
-
-
-
-CONFIGURATION OVERRIDE
+Configuration Override
Most commands allow the override of specific
configuration options on the command line, using the -o option. This option has the form
+
+