READER.CONF(5)                                             PC/SC Lite                                             READER.CONF(5)



NAME
       reader.conf - configuration file for pcscd readers' drivers

DESCRIPTION
       The /etc/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 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  han-
       dler  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 kernel. 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 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.rousseauATfree.fr>

SEE ALSO
       pcscd(8), pcsc_scan(1)



Muscle                                                     August 2005                                            READER.CONF(5)