READER.CONF(5) PC/SC Lite READER.CONF(5)NAME
reader.conf - configuration file for pcscd readers' drivers
DESCRIPTION
The /etc/reader.conf.d/reader.conf file contains configuration information for serial and (some) PCMCIA smart card readers.
USB readers SHALL NOT be configured using this file. pcscd uses another mechanism to automatically load USB drivers.
SYNTAX
The /etc/reader.conf.d/reader.conf is a regular text file. Each reader must be defined by four fields:
FRIENDLYNAME TEXT_STRING
DEVICENAME FILENAME
LIBPATH FILENAME
CHANNELID NUMBER
The "FRIENDLYNAME" field is an arbitrary text used to identify the reader. This text is displayed by commands like pcsc_scan(1) that prints
the names of all the connected and detected readers.
The "DEVICENAME" field was not used for old drivers (using the IFD handler version 2.0 or earlier). It is now (IFD handler version 3.0)
used to identify the physical port on which the reader is connected. This is the device name of this port. It is dependent of the OS ker-
nel. The first serial port device is called /dev/ttyS0 under Linux and /dev/cuaa0 under FreeBSD.
The "LIBPATH" field is the filename of the driver code. The driver is a dynamically loaded piece of code (generally a drivername.so*file).
The "CHANNELID" is no more used for recent drivers (IFD handler 3.0) and has been superseded by "DEVICENAME". If you have an old driver
this field is used to indicate the port to use. You should read your driver documentation to know what information is needed here. It
should be the serial port number for a serial reader.
EXAMPLE
# Gemplus GemPCTwin reader with serial communication
# connected to the first serial port
FRIENDLYNAME "GemPCTwin serial"
DEVICENAME /dev/ttyS0
LIBPATH /usr/lib/pcsc/drivers/serial/libccidtwin.so.0.4.1
CHANNELID 1
DEBUGGING
In order to set up your /etc/reader.conf.d/reader.conf file correctly you may want to have debug messages from pcscd. I recommend you to
start pscsd in the foreground and debug mode using:
# pcscd --foreground --debug
If everything seems OK you can use the pcsc_scan command to print the list of correctly detected readers and try to get the ATR of your
smart cards.
AUTHOR
Ludovic Rousseau <ludovic.rousseau@free.fr>
SEE ALSO pcscd(8), pcsc_scan(1)Muscle August 2005 READER.CONF(5)
Check Out this Related Man Page
PCSCD(8) PC/SC Lite PCSCD(8)NAME
pcscd - PC/SC Smart Card Daemon
SYNOPSIS
pcscd [options]
OPTIONS -a, --apdu
log APDUs and SW using the debug method (see --debug).
-c, --config file
Specifies the file file as an alternate location for /etc/reader.conf.d/reader.conf.
-f, --foreground
Runs pcscd in the foreground and sends log messages to stderr instead of syslog(3).
-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 --fore-
ground.
--info use info log level. This is the default log level.
--error
use error log level.
--critical
use critical log level.
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.
-h, --help
Displays information about the pcscd command line
-v, --version
Displays the program version number
-H, --hotplug
Ask pcscd to rescan the USB buses for added or removed readers and re-read the /etc/reader.conf.d/reader.conf file to detect added
or removed non-USB readers (serial or PCMCIA).
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.
It allows applications to access smart cards and readers using the winscard API but without knowing details of the card or reader.
pcscd coordinates the loading of drivers for card readers.
SERIAL SMART CARD READER DRIVERS
Smart card reader drivers are placed in the /usr/lib/pcsc/drivers directory. Each driver is simply an .so file. pcscd locates the driver
using the /etc/reader.conf.d/reader.conf file. See the reader.conf(5) manual page for more information. Drivers are available at
http://www.musclecard.com/drivers.html.
USB SMART CARD READER DRIVERS
USB smart card reader drivers are located in /usr/lib/pcsc/drivers directory as a bundle. You shall not add a USB driver in
/etc/reader.conf.d/reader.conf file.
FILES
/etc/reader.conf.d/reader.conf : Reader configuration file
/var/run/pcscd/pcscd.pid : process id of the running pcscd
/usr/lib/pcsc/drivers : directory containing bundles for USB drivers
SEE ALSO bundleTool(8), reader.conf(5), syslog(3)AUTHORS
David Corcoran <corcoran@musclecard.com> and Ludovic Rousseau <ludovic.rousseau@free.fr>
Muscle January 2007 PCSCD(8)