.TH "libchipcard.conf" "5" "@rpm_version@" "Martin Preuss" "Config File Syntax"
.SH "NAME"
.LP 
\fBLibChipCard\fR \- Configuration file syntax for LibChipCard

.SH "DESCRIPTION"
.LP 
LibChipCard uses configuration files whose general format is described in this document.
.SH "SYNTAX"
.LP 
A configuration file for LibChipCard consists of configuration \fIgroups\fR and \fIvariables\fR. The name of a group is given within square brackets (e.g. \fI[some/name]\fR). As you can see in this example the configuration groups are organized in a sort of tree.
.BR 
So the group "\fI[parent/child]\fR" is a subgroup of "\fI[parent]\fR".
.BR 
The definition of a group must be the only definition in a single line, it may not be followed by any other definition on the same line.
.BR 
All variable definitions that follow a group definition in subsequent lines belong to that group. A variable may have muliple values separated by commas.
.br 


.SH "EXAMPLE"
.LP 
The follwoing example demonstrates the syntax of a configuration file for LibChipCard:
.BR 

.TP 
# Remarks are introduced like in shell scripts
.TP 
# The config file code ignores remarks completely
.TP 
[parent]
.TP 
v1="1"     # this variable has a single value
.TP 
v2="2","3" # this variable has 2 values (list of values)
.br 
.TP 
[parent/child1] # this group is a child to \fIparent\fR
.TP 
v1="child1_v1"
.TP 
v2="child1_v2"
.BR 
.SH "FILES"
.LP 
.TP 
@CHIPCARDC_CFGFILE@
.TP 
@CHIPCARDD_CFGFILE@
.TP 
@CHIPCARD_COMMANDS@/*.cmd
.BR 
.SH "SEE ALSO"
.LP 
chipcardc.conf(5) chipcardd.conf(5) chipcard.cmd(5)