.\"Generated by db2man.xsl. Don't modify this, modify the source.
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "AMGETCONF" 8 "" "" ""
.SH NAME
amgetconf \- look up amanda.conf variables
.SH "SYNOPSIS"
.ad l
.hy 0
.HP 10
\fBamgetconf\fR [\fIconfig\fR] \fIparameter\fR
.ad
.hy

.SH "DESCRIPTION"

.PP
\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\&.

.PP
If \fBconfig\fR is not specified, \fBamgetconf\fR assumes it is being run from the configuration directory and that \fBamanda\&.conf\fR is present\&.

.PP
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\&.

.PP
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\&.

.PP
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\&.

.PP
See the \fBamanda\fR(8) man page for more details about \fBAmanda\fR\&.

.SH "EXAMPLE"

.PP
Find out the path to the log file directory:

.nf

% amgetconf daily logdir
/usr/local/etc/amanda//daily

.fi

.PP
Find out the current tape type:

.nf

% amgetconf daily tapetype
DLT4000\-IV

.fi

.PP
Find out the default configuration directory:

.nf

% amgetconf daily build\&.CONFIG_DIR
/usr/local/etc/amanda/

.fi

.PP
Create, use and close a debug file in a script:

.nf

% set debug_file = `amgetconf daily dbopen\&.myscript`
% echo debug information >> $debug_file
% amgetconf daily dbclose\&.myscript:$debug_file

.fi

.SH "MESSAGES"

.TP
amgetconf: no such parameter \fBparam\fR
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\&.

.SH "SEE ALSO"

.PP
\fBamanda\fR(8)