Provided by: pcscd_1.4.102-1ubuntu2_i386 bug

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 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 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.rousseau@free.fr>

SEE ALSO

       pcscd(8), pcsc_scan(1)