Imported Upstream version 2.5.1p1
[debian/amanda] / docs / amgetconf.8.txt
1
2                              amgetconf
3 Prev  Chapter 36. The Amanda Manual Pages.  Next
4
5 -------------------------------------------------------------------------------
6
7 Name
8
9 amgetconf \14 look up amanda.conf variables
10
11 Synopsis
12
13 amgetconf [config] parameter [ -o | configoption ]*
14
15 DESCRIPTION
16
17 Amgetconf looks up parameters in amanda.conf, the Amanda configuration file, or
18 from the build and runtime environment, and returns their corresponding value.
19 If config is not specified, amgetconf assumes it is being run from the
20 configuration directory and that amanda.conf is present.
21 If parameter begins with build., the (case insensitive) string following the
22 period is a build environment variable. Variables without a value (e.g. XFSDUMP
23 on a system that does not support that type of file system) will not report an
24 error and will return an empty string as the value. Flag variables (e.g.
25 USE_AMANDAHOSTS) will return 1 if the flag is set or an empty string if it is
26 not.
27 If parameter begins with dbopen., the string following the period is a program
28 name and an Amanda debug file will be created for the caller. The name of the
29 file is returned.
30 If parameter begins with dbclose., the string following the period is a program
31 name previously used with dbopen., followed by a colon (:) and the previously
32 opened file name.
33 See the amanda(8) man page for more details about Amanda.
34
35 OPTIONS
36
37
38
39   -o configoption
40       See the "CONFIGURATION OVERWRITE" section in amanda(8).
41
42
43 EXAMPLE
44
45 Find out the path to the log file directory:
46
47 % amgetconf daily logdir
48 /usr/local/etc/amanda//daily
49 Find out the current tape type:
50
51 % amgetconf daily tapetype
52 DLT4000-IV
53 Find out the default configuration directory:
54
55 % amgetconf daily build.CONFIG_DIR
56 /usr/local/etc/amanda/
57 Create, use and close a debug file in a script:
58
59 % set debug_file = `amgetconf daily dbopen.myscript`
60 % echo debug information >> $debug_file
61 % amgetconf daily dbclose.myscript:$debug_file
62
63 MESSAGES
64
65
66
67   amgetconf: no such parameter param
68       Parameter param is not a known keyword (e.g. not a valid amanda.conf
69       keyword).
70
71
72 SEE ALSO
73
74 amanda(8)
75 -------------------------------------------------------------------------------
76
77 Prev      Up      Next
78 amflush  Home  amlabel
79