1 .\"Generated by db2man.xsl. Don't modify this, modify the source.
10 .de Sp \" Vertical space (when we can't use .PP)
16 .ie \\n(.$>=3 .ne \\$3
20 .TH "AMGETCONF" 8 "" "" ""
22 amgetconf \- look up amanda.conf variables
27 \fBamgetconf\fR [\fIconfig\fR] \fIparameter\fR
34 \fBAmgetconf\fR looks up parameters in \fBamanda\&.conf\fR, the \fBAmanda\fR configuration file, or from the build and runtime environment, and returns their corresponding value\&.
37 If \fBconfig\fR is not specified, \fBamgetconf\fR assumes it is being run from the configuration directory and that \fBamanda\&.conf\fR is present\&.
40 If \fBparameter\fR begins with \fBbuild\&.\fR, the (case insensitive) string following the period is a build environment variable\&. Variables without a value (e\&.g\&. \fBXFSDUMP\fR on a system that does not support that type of file system) will not report an error and will return an empty string as the value\&. Flag variables (e\&.g\&. \fBUSE_AMANDAHOSTS\fR) will return 1 if the flag is set or an empty string if it is not\&.
43 If \fBparameter\fR begins with \fBdbopen\&.\fR, the string following the period is a program name and an \fBAmanda\fR debug file will be created for the caller\&. The name of the file is returned\&.
46 If \fBparameter\fR begins with \fBdbclose\&.\fR, the string following the period is a program name previously used with \fBdbopen\&.\fR, followed by a colon (:) and the previously opened file name\&.
49 See the \fBamanda\fR(8) man page for more details about \fBAmanda\fR\&.
54 Find out the path to the log file directory:
58 % amgetconf daily logdir
59 /usr/local/etc/amanda//daily
64 Find out the current tape type:
68 % amgetconf daily tapetype
74 Find out the default configuration directory:
78 % amgetconf daily build\&.CONFIG_DIR
79 /usr/local/etc/amanda/
84 Create, use and close a debug file in a script:
88 % set debug_file = `amgetconf daily dbopen\&.myscript`
89 % echo debug information >> $debug_file
90 % amgetconf daily dbclose\&.myscript:$debug_file
97 amgetconf: no such parameter \fBparam\fR
98 Parameter \fBparam\fR is not a known keyword (e\&.g\&. not a valid \fBamanda\&.conf\fR keyword)\&. In this case, \fBamgetconf\fR will write "\fBBUGGY\fR" to stdout as the value\&.