bionic (5) reader.conf.5.gz

Provided by: pcscd_1.8.23-1_amd64 bug

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 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.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)