.\" Copyright (c) 2003-2012
.\" Distributed Systems Software.  All rights reserved.
.\" See the file LICENSE for redistribution information.
.\" $Id: copyright-nr 2564 2012-03-02 00:17:08Z brachman $
'\" t
.\"     Title: dacsconf
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 02/19/2019
.\"    Manual: DACS Commands Manual
.\"    Source: DACS 1.4.40
.\"  Language: English
.\"
.TH "DACSCONF" "1" "02/19/2019" "DACS 1.4.40" "DACS Commands Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
dacsconf \- display configuration directives
.SH "SYNOPSIS"
.HP \w'\fBdacsconf\fR\ 'u
\fBdacsconf\fR [\fI\m[blue]\fBdacsoptions\fR\m[]\&\s-2\u[1]\d\s+2\fR] [\fB\-vars\fR] [\fIdirective\-name\fR...]
.HP \w'\fBdacsconf\fR\ 'u
\fBdacsconf\fR [\fB\-item_types\fR]
.SH "DESCRIPTION"
.PP
This program is part of the
\fBDACS\fR
suite\&.
.PP
The
\fBdacsconf\fR
utility processes
\fBDACS\fR
configuration files (see
\m[blue]\fBdacs\&.conf(5)\fR\m[]\&\s-2\u[2]\d\s+2) and outputs to
stdout
the values of directives or variable references currently in effect for the specified jurisdiction\&.
.PP
Although the order in which clauses appear in configuration files can be important, the order of configuration directives is for the most part not significant\&. The exception is the
\m[blue]\fBEVAL\fR\m[]\&\s-2\u[3]\d\s+2
directive\&. These directives are listed in the order in which they would be evaluated, and their
\fIunevaluated\fR
values appear in the output\&.
.PP
This program is also available as a
\fBDACS\fR
web service,
\m[blue]\fBdacs_conf(8)\fR\m[]\&\s-2\u[4]\d\s+2\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBSecurity\fR
.ps -1
.br
.PP
Because the configuration might reveal information that could be taken advantage of by an attacker, only the
\fBDACS\fR
administrator should be able to run this command\&.
.sp .5v
.RE
.SH "OPTIONS"
.PP
\fB\-item_types\fR
.RS 4
List the names of all predefined item types\&. The presence of a name does not imply that
\fBDACS\fR
has been configured to use the item type\&.
.RE
.PP
\fB\-vars\fR
.RS 4
By default, directives that appear within a clause (e\&.g\&., <Auth> or <Roles>) are emitted in the context of that clause\&. This option "flattens" the output by emitting it in the form of
\fBDACS\fR
variables\&.
.sp
For example, the
STYLE
directive in an
Auth
section having an
id
of
foo
will appear as
\fIAUTH\&.FOO\&.STYLE\fR
in the output\&.
.sp
All variables in the
\fIConf\fR
namespace are displayed, including those set by
EVAL\&.
.RE
.PP
\fIdirective\-name\fR
.RS 4
One or more directive names or variable references may be provided to limit the output\&. It is not an error if a
\fIdirective\-name\fR
is not defined\&.
.RE
.SH "FILES"
.PP
\m[blue]\fBconf\&.css\fR\m[]\&\s-2\u[5]\d\s+2
.SH "DIAGNOSTICS"
.PP
The program exits
0
if everything was fine,
1
if an error occurred\&. Error messages are printed to
stderr\&.
.SH "SEE ALSO"
.PP
\m[blue]\fBdacs_conf(8)\fR\m[]\&\s-2\u[4]\d\s+2,
\m[blue]\fBdacs\&.conf(5)\fR\m[]\&\s-2\u[2]\d\s+2
.SH "AUTHOR"
.PP
Distributed Systems Software (\m[blue]\fBwww\&.dss\&.ca\fR\m[]\&\s-2\u[6]\d\s+2)
.SH "COPYING"
.PP
Copyright \(co 2003\-2012 Distributed Systems Software\&. See the
\m[blue]\fBLICENSE\fR\m[]\&\s-2\u[7]\d\s+2
file that accompanies the distribution for licensing information\&.
.SH "NOTES"
.IP " 1." 4
dacsoptions
.RS 4
\%http://dacs.dss.ca/man/dacs.1.html#dacsoptions
.RE
.IP " 2." 4
dacs.conf(5)
.RS 4
\%http://dacs.dss.ca/man/dacs.conf.5.html
.RE
.IP " 3." 4
EVAL
.RS 4
\%http://dacs.dss.ca/man/dacs.conf.5.html#EVAL
.RE
.IP " 4." 4
dacs_conf(8)
.RS 4
\%http://dacs.dss.ca/man/dacs_conf.8.html
.RE
.IP " 5." 4
conf.css
.RS 4
\%http://dacs.dss.ca/man//css/conf.css
.RE
.IP " 6." 4
www.dss.ca
.RS 4
\%http://www.dss.ca
.RE
.IP " 7." 4
LICENSE
.RS 4
\%http://dacs.dss.ca/man/../misc/LICENSE
.RE