GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  READER.CONF (5)

NAME

reader.conf - configuration file for pcscd readers’ drivers

CONTENTS

Description
Syntax
Example
Debugging
Author
See Also

DESCRIPTION

The /usr/local/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 /usr/local/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/local/lib/pcsc/drivers//serial/libccidtwin.so.0.4.1
CHANNELID 1

DEBUGGING

In order to set up your /usr/local/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)
Search for    or go to Top of page |  Section 5 |  Main Index


Muscle READER.CONF (5) August 2005

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.