135 lines
3.7 KiB
Groff
135 lines
3.7 KiB
Groff
.TH PCSCD 8 "December 2021" Muscle "PC/SC Lite"
|
|
.SH NAME
|
|
pcscd \- PC/SC Smart Card Daemon
|
|
.
|
|
.SH SYNOPSIS
|
|
.B pcscd
|
|
.RI [ options ]
|
|
.
|
|
.SH OPTIONS
|
|
.TP
|
|
.BR -a ", " \-\-apdu
|
|
log APDUs and SW using the debug method (see
|
|
.BR \-\-debug ).
|
|
.TP
|
|
.BR \-c ", " \-\-config " \fIdir\fP"
|
|
Specifies the directory \fIdir\fP as an alternate location for
|
|
.IR @PCSCLITE_CONFIG_DIR@/ .
|
|
The argument can also be a single configuration file (for backward
|
|
compatibility).
|
|
.TP
|
|
.BR \-f ", " \-\-foreground
|
|
Runs pcscd in the foreground and sends log messages to stderr instead of
|
|
syslog(3).
|
|
.TP
|
|
.BR \-T ", " \-\-color
|
|
force use of colored logs.
|
|
.TP
|
|
.BR \-d ", " \-\-debug
|
|
use the lowest log level. Any log message of this level or above will be
|
|
sent to stderr or syslog(3) depending on the use of
|
|
.BR \-\-foreground .
|
|
.TP
|
|
.B \-\-info
|
|
use info log level. This is the default log level.
|
|
.TP
|
|
.BR \-e ", " \-\-error
|
|
use error log level.
|
|
.TP
|
|
.BR \-C ", " \-\-critical
|
|
use critical log level.
|
|
.PP
|
|
The log levels are ordered as: debug < info < error < critical. Use a
|
|
log level l will log this level and all the levels above it.
|
|
.TP
|
|
.B \-\-force\-reader\-polling
|
|
ignore the IFD_GENERATE_HOTPLUG reader capability
|
|
.TP
|
|
.BR \-t ", " \-\-max\-thread
|
|
maximum number of threads (default 200).
|
|
|
|
This is the maximum number of clients (SCardEstablishContext) that pcscd
|
|
can handle.
|
|
.TP
|
|
.BR \-s ", " \-\-max\-card\-handle\-per\-thread
|
|
maximum number of card handle per thread (default: 200).
|
|
|
|
This is the maximum number of card handle (SCardConnect) per client
|
|
(SCardEstablishContext).
|
|
.TP
|
|
.BR \-r ", " \-\-max\-card\-handle\-per\-reader
|
|
maximum number of card handle per reader (default: 200)
|
|
|
|
This is the maximum number of card handle (SCardConnect) per reader.
|
|
.TP
|
|
.BR \-h ", " \-\-help
|
|
Displays information about the pcscd command line
|
|
.TP
|
|
.BR \-v ", " \-\-version
|
|
Displays the program version number
|
|
.TP
|
|
.BR \-H ", " \-\-hotplug
|
|
Ask pcscd to re-read the
|
|
.I @PCSCLITE_CONFIG_DIR@/my_reader.conf
|
|
files to detect added or removed non-USB readers (serial or PCMCIA).
|
|
.
|
|
.TP
|
|
.BR \-x ", " \-\-auto\-exit
|
|
pcscd will quit after 60 seconds of inactivity after the release of
|
|
the last PC/SC context. This is used when pcscd
|
|
os started on demand by systemd.
|
|
.TP
|
|
.BR \-S ", " \-\-reader\-name\-no\-serial
|
|
Do not include the USB serial number in the reader name.
|
|
.TP
|
|
.BR \-I ", " \-\-reader\-name\-no\-interface
|
|
Do not include the USB interface name in the reader name.
|
|
.SH DESCRIPTION
|
|
pcscd is the daemon program for pcsc-lite. It is a resource manager that
|
|
coordinates communications with smart card readers and smart cards and
|
|
cryptographic tokens that are connected to the system.
|
|
.PP
|
|
It allows applications to access smart cards and readers using the
|
|
winscard API but without knowing details of the card or reader.
|
|
.PP
|
|
pcscd coordinates the loading of drivers for card readers.
|
|
.
|
|
.SH "SERIAL SMART CARD READER DRIVERS"
|
|
Smart card reader drivers are placed in the
|
|
.I @usbdropdir@
|
|
directory. Each driver is simply an
|
|
.I .so
|
|
file. pcscd locates the driver using the
|
|
.I @PCSCLITE_CONFIG_DIR@/my_reader.conf
|
|
files. See the
|
|
.BR reader.conf (5)
|
|
manual page for more information.
|
|
.PP
|
|
Some drivers are available at \fIhttps://muscle.apdu.fr/musclecard.com/drivers.html\fP.
|
|
.
|
|
.SH "USB SMART CARD READER DRIVERS"
|
|
USB smart card reader drivers are located in
|
|
.I @usbdropdir@
|
|
directory as a bundle. You shall NOT add a USB driver in a
|
|
.I @PCSCLITE_CONFIG_DIR@/my_reader.conf
|
|
file.
|
|
.
|
|
.SH FILES
|
|
.I @PCSCLITE_CONFIG_DIR@/*
|
|
: Serial reader configuration files
|
|
.PP
|
|
.I @ipcdir@/pcscd.pid
|
|
: process id of the running pcscd
|
|
.PP
|
|
.I @usbdropdir@/
|
|
: directory containing bundles for USB drivers
|
|
.
|
|
.SH "SEE ALSO"
|
|
.BR bundleTool (8),
|
|
.BR reader.conf (5),
|
|
.BR syslog (3)
|
|
.
|
|
.SH AUTHORS
|
|
David Corcoran <corcoran@musclecard.com> and Ludovic Rousseau
|
|
<ludovic.rousseau@free.fr>
|