.TH "chipcardc.conf" "5" "@rpm_version@" "Martin Preuss" "Client Config File Format"
.SH "NAME"
.LP 
\fBchipcardc.conf\fR \- LibChipCard client configuration file format
.SH "DESCRIPTION"
.LP 
All applications which are using LibChipCard are configured via a configuration file called \fBchipcardc.conf\fR. This configuration file is expected to be in \fI@CHIPCARDC_CFGFILE@\fR.
.BR 

Please see \fIlibchipcard.conf(5)\fR for a description of the basic syntax of configuration files for LibChipCard.
.SH "ROOT"
.LP 
The root contains general information about the client mode.

\fBtimeout\fR 
.IP 
Time to wait in milliseconds for server responses per round. In each round LibChipCard first waits up the the time given here for server responses. After that it handles these responses.Recommended values are 500\-1000 (best is 750)
.BR 
.LP 
\fBmaxmsg\fR
.IP 
Maximum number of response to handle per loop (see above for an explanation for the round)
.BR 

.SH "SERVICE"
.LP 
The configuration file holds one or more service groups which describe where card servers are located. These groups are enumerated, so that the second element of the groupname is the sequence number in a list of services (e.g. \fI[service/1]\fR is the first service, \fI[service/2]\fR is the second and so on.

\fBaddress\fR 
.IP 
Address of a machine that runs a card server. This address can be given in 3\-dot notation (e.g. 1.2.3.4) or as the hostname, which will be looked up.
.br 
\fBPlease note\fR: If you only want to use local services (i.e. not sharing the readers between multiple hosts) then you should use the address \fI127.0.0.1\fR (or \fIlocalhost\fR).
.BR 
.LP 
\fBport\fR
.IP 
TCP port the card server is listening on. The default value is \fI32891\fR.
.BR 



.SH "EXAMPLE"
.LP 
This is a simple configuration file which uses a local card server listening at port 32891 (which is the default port).
.BR 

.IP 
timeout="750"
.BR 

maxmsg="20"
.BR 

[service/1]
.BR 

address="127.0.0.1"
.BR 

port="32891"
.BR 

.LP 

.SH "FILES"
.LP 
@CHIPCARDC_CFGFILE@
.SH "SEE ALSO"
.LP 
libchipcard.conf(5) chipcardd.conf(5)