1READER.CONF(5)                    PC/SC Lite                    READER.CONF(5)
2
3
4

NAME

6       reader.conf - configuration file for pcscd readers' drivers
7

DESCRIPTION

9       The /etc/reader.conf file contains configuration information for serial
10       and (some) PCMCIA smart card readers.
11
12       USB readers SHALL NOT  be  configured  using  this  file.   pcscd  uses
13       another mechanism to automatically load USB drivers.
14

SYNTAX

16       The  /etc/reader.conf  is  a  regular  text  file.  Each reader must be
17       defined by four fields:
18
19        FRIENDLYNAME     TEXT_STRING
20        DEVICENAME       FILENAME
21        LIBPATH          FILENAME
22        CHANNELID        NUMBER
23
24       The "FRIENDLYNAME" field is an arbitrary  text  used  to  identify  the
25       reader.  This  text  is  displayed  by  commands like pcsc_scan(1) that
26       prints the names of all the connected and detected readers.
27
28       The "DEVICENAME" field was not used for old drivers (using the IFD han‐
29       dler  version 2.0 or earlier). It is now (IFD handler version 3.0) used
30       to identify the physical port on which the reader is connected. This is
31       the  device  name  of  this port. It is dependent of the OS kernel. The
32       first  serial  port  device  is  called  /dev/ttyS0  under  Linux   and
33       /dev/cuaa0 under FreeBSD.
34
35       The "LIBPATH" field is the filename of the driver code. The driver is a
36       dynamically loaded piece of code (generally a drivername.so*file).
37
38       The "CHANNELID" is no more used for recent drivers  (IFD  handler  3.0)
39       and has been superseded by "DEVICENAME". If you have an old driver this
40       field is used to indicate the port to use. You should read your  driver
41       documentation to know what information is needed here. It should be the
42       serial port number for a serial reader.
43

EXAMPLE

45        # Gemplus GemPCTwin reader with serial communication
46        # connected to the first serial port
47        FRIENDLYNAME      "GemPCTwin serial"
48        DEVICENAME        /dev/ttyS0
49        LIBPATH           /usr/lib64/pcsc/drivers/serial/libccidtwin.so.0.4.1
50        CHANNELID         1
51

DEBUGGING

53       In order to set up your /etc/reader.conf file correctly you may want to
54       have  debug messages from pcscd.  I recommend you to start pscsd in the
55       foreground and debug mode using:
56        # pcscd --foreground --debug
57
58       If everything seems OK you can use the pcsc_scan command to  print  the
59       list of correctly detected readers and try to get the ATR of your smart
60       cards.
61

AUTHOR

63       Ludovic Rousseau <ludovic.rousseau@free.fr>
64

SEE ALSO

66       pcscd(8), pcsc_scan(1)
67
68
69
70Muscle                            August 2005                   READER.CONF(5)
Impressum