X-Git-Url: https://git.gag.com/?a=blobdiff_plain;f=man%2Fxml-source%2Famanda.conf.5.xml;fp=man%2Fxml-source%2Famanda.conf.5.xml;h=adcae4f97b83f6a3b6c33617630d134a2032cfdd;hb=310f09c0f55a2fb6f3f3746d6ded20099792b773;hp=78057a4cea08e02b79eb6f064ef26f6d9eda6545;hpb=13d6d10aa48f1dfb956ccff2f72dbaa255073472;p=debian%2Famanda diff --git a/man/xml-source/amanda.conf.5.xml b/man/xml-source/amanda.conf.5.xml index 78057a4..adcae4f 100644 --- a/man/xml-source/amanda.conf.5.xml +++ b/man/xml-source/amanda.conf.5.xml @@ -110,10 +110,10 @@ some of which have a multiplier effect: Some number of weeks (days*7). -The value +The value inf may be used in most places where an integer is expected -to mean an infinite amount. +to mean an infinite amount. Boolean arguments may have any of the values y, @@ -171,7 +171,7 @@ A space separated list of recipients for mail reports. The number of days in the backup cycle. Each disk will get a full backup at least this often. Setting this to zero tries to do a full backup each run. -This parameter may also be set in a specific +This parameter may also be set in a specific dumptype (see below). This value sets the default for all @@ -180,10 +180,11 @@ so must appear in amanda.conf before any dumptypes -are defined. +are defined. + - + runspercycle int @@ -556,16 +557,16 @@ The unit used to print many numbers, k=kilo, m=mega, g=giga, t=tera. Default: tttTTTTTTT. -The priority order of each dumper: +The priority order of each dumper: - -s: smallest size -S: largest size -t: smallest time -T: largest time -b: smallest bandwidth -B: largest bandwidth - + +s: smallest size +S: largest size +t: smallest time +T: largest time +b: smallest bandwidth +B: largest bandwidth + @@ -815,44 +816,44 @@ is a comma (',') separated list of triples. Each triple consists of three parts which are separated by a equal sign ('=') and a colon (':') (see the example). These three parts specify: - + the name of the column, which may be: - - Compress (compression ratio) - Disk (client disk name) - DumpRate (dump rate in KBytes/sec) - DumpTime (total dump time in hours:minutes) - HostName (client host name) - Level (dump level) - OrigKB (original image size in KBytes) - OutKB (output image size in KBytes) - TapeRate (tape writing rate in KBytes/sec) - TapeTime (total tape time in hours:minutes) - + + Compress (compression ratio) + Disk (client disk name) + DumpRate (dump rate in KBytes/sec) + DumpTime (total dump time in hours:minutes) + HostName (client host name) + Level (dump level) + OrigKB (original image size in KBytes) + OutKB (output image size in KBytes) + TapeRate (tape writing rate in KBytes/sec) + TapeTime (total tape time in hours:minutes) + -the amount of space to display before the column (used to get whitespace between columns). +the amount of space to display before the column (used to get whitespace between columns). the width of the column itself. If set to a negative value, the width will be calculated on demand to fit the largest entry in this column. - - -Here is an example: + +Here is an example: -columnspec "Disk=1:18,HostName=0:10,OutKB=1:7" - +columnspec "Disk=1:18,HostName=0:10,OutKB=1:7" + + The above will display the disk information in 18 characters and put one space before it. The hostname column will be 10 characters wide with no space to the left. The output KBytes column is seven characters wide -with one space before it. +with one space before it. @@ -896,6 +897,7 @@ is a logical name for this holding disk. A comment string describing this holding disk. + directory disk @@ -904,40 +906,42 @@ A comment string describing this holding disk. The path to this holding area. + use int -Default: +Default: 0 Gb. Amount of space that can be used in this holding disk area. If the value is zero, all available space on the file system is used. -If the value is negative, &A; will use all available space minus that value. +If the value is negative, &A; will use all available space minus that value. + chunksize int -Default: +Default: 1 Gb. Holding disk chunk size. Dumps larger than the specified size will be stored in multiple holding disk files. The size of each chunk will not exceed the specified value. However, even though dump images are split in the holding disk, they are concatenated as they are written to tape, so each dump image still corresponds to a single continuous -tape section. +tape section. -If 0 is specified, &A; will create holding disk chunks as large as -((INT_MAX/1024)-64) Kbytes. +If 0 is specified, &A; will create holding disk chunks as large as +((INT_MAX/1024)-64) Kbytes. -Each holding disk chunk includes a 32 Kbyte header, so the minimum -chunk size is 64 Kbytes (but that would be really silly). +Each holding disk chunk includes a 32 Kbyte header, so the minimum +chunk size is 64 Kbytes (but that would be really silly). -Operating systems that are limited to a maximum file size of 2 Gbytes +Operating systems that are limited to a maximum file size of 2 Gbytes actually cannot handle files that large. They must be at least one byte less than 2 Gbytes. Since &A; works with 32 Kbyte blocks, and to handle the final read at the end of the chunk, the chunk size should be at least 64 Kbytes (2 * 32 Kbytes) smaller than the maximum -file size, e.g. 2047 Mbytes. +file size, e.g. 2047 Mbytes. @@ -1148,24 +1152,39 @@ is often not as good a compression as but usually less CPU overhead. Or to specify Custom to use your own compression method. (See dumptype custom-compress in example/amanda.conf for reference) - - So the compress options line may be one of: - -compress none -compress [client] fast -compress [client] best -compress client custom -Specify client_custom_compress "PROG" -PROG must not contain white space and it must accept -d for uncompress. -compress server fast -compress server best -compress server custom -Specify server_custom_compress "PROG" -PROG must not contain white space and it must accept -d for uncompress. - - + + + compress none + + + compress client fast + + + compress client best + + + compress client custom + + Specify client_custom_compress "PROG" + PROG must not contain white space and it must accept -d for uncompress. + + + + compress server fast + + + compress server best + + + compress server custom + + Specify server_custom_compress "PROG" + PROG must not contain white space and it must accept -d for uncompress. + + + Note that some tape devices do compression and this option has nothing to do with whether that is used. If hardware compression is used (usually via a particular tape device name or mt option), &A; (software) compression should be disabled. @@ -1191,30 +1210,38 @@ server host as it goes from the network into the holding disk or to tape. So the encrypt options line may be one of: - -encrypt none -encrypt client -Specify client_encrypt "PROG" -PROG must not contain white space. -Specify client_decrypt_option "decryption-parameter" Default: "-d" -decryption-parameter must not contain white space. -(See dumptype server-encrypt-fast in example/amanda.conf for reference) - -encrypt server -Specify server_encrypt "PROG" -PROG must not contain white space. -Specify server_decrypt_option "decryption-parameter" Default: "-d" -decryption-parameter must not contain white space. -(See dumptype client-encrypt-nocomp in example/amanda.conf for reference) - - - + + + encrypt none + + + encrypt client + + Specify client_encrypt "PROG" + PROG must not contain white space. + Specify client_decrypt_option "decryption-parameter" Default: "-d" + decryption-parameter must not contain white space. + (See dumptype server-encrypt-fast in example/amanda.conf for reference) + + + + encrypt server + + Specify server_encrypt "PROG" + PROG must not contain white space. + Specify server_decrypt_option "decryption-parameter" Default: "-d" + decryption-parameter must not contain white space. + (See dumptype client-encrypt-nocomp in example/amanda.conf for reference) + + + Note that current logic assumes compression then encryption during backup(thus decrypt then uncompress during restore). So specifying client-encryption AND server-compression is not supported. amcrypt which is a wrapper of aespipe is provided as a reference symmetric encryption program. + @@ -1223,31 +1250,35 @@ client-encryption AND server-compression is not supported. Default: client. Determine the way &A; does it's estimate. - - -client: - -Use the same program as the dumping program, this is the most accurate way to do estimates, but it can take a long time. - - - -calcsize: -Use a faster program to do estimates, but the result is less accurate. - - -server: -Use only statistics from the previous run to give an estimate, -it takes only a few seconds but the result is not accurate if your disk -usage changes from day to day. - - - - + + + client + + Use the same program as the dumping program, this is the most + accurate way to do estimates, but it can take a long time. + + + calcsize + + Use a faster program to do estimates, but the result is less accurate. + + + + server + + Use only statistics from the previous run to give an estimate, + it takes only a few seconds but the result is not accurate if your disk + usage changes from day to day. + + + + + - exclude [ list|file ][[optional][ append ][ string ]+] + exclude [ list|file ][[optional][ append ][ string ]+] Default: file. @@ -1299,7 +1330,7 @@ for a backup of /var, - holdingdisk [ never|auto|required] ] + holdingdisk [ never|auto|required ] Default: auto. @@ -1348,7 +1379,7 @@ some of which should not back up all the listed file systems. - include [ list|file ][[optional][ append ][ string ]+] + include [ list|file ][[optional][ append ][ string ]+] Default: file @@ -1373,8 +1404,9 @@ is a file name on the client containing glob expressions. Include expressions must always be specified as relative to the head directory of the DLE. -For globbing to work at all, even the limited single level, -the top level directory of the DLE must be readable by the &A; user. +For globbing to work at all, even the limited single level, +the top level directory of the DLE must be readable by the &A; user. + With the append keyword, the string is appended to the current list, without it, the @@ -1679,10 +1711,10 @@ A comment string describing this set of tape information. filemark int Default: -1000 bytes. -How large a file mark (tape mark) is, measured in bytes. +1 kbytes. +How large a file mark (tape mark) is, measured in kbytes. If the size is only known in some linear measurement (e.g. inches), -convert it to bytes using the device density. +convert it to kbytes using the device density. @@ -1704,7 +1736,7 @@ manpage for exceptions). blocksize int Default: -32. +32 kbytes. How much data will be written in each tape record expressed in KiloBytes. The tape record size (= blocksize) can not be reduced below the default 32 KBytes. The parameter blocksize can only be raised if &A; was compiled with the configure option