← Back to branch summary

~ubuntu-branches/ubuntu/jaunty/pcsc-lite/jaunty-security

« back to all changes in this revision

Viewing changes to doc/reader.conf.5.in

  • Committer: Bazaar Package Importer
  • Author(s): Ludovic Rousseau
  • Date: 2004-06-13 21:45:56 UTC
  • mfrom: (1.1.1 upstream)
  • mto: This revision was merged to the branch mainline in revision 3.
  • Revision ID: james.westby@ubuntu.com-20040613214556-zio7hrzkz9wwtffx
Tags: 1.2.9-beta2-2
http://bugs.debian.org/253629
http://bugs.debian.org/249374
* debian/rules: add -lpthread to LDFLAGS so that pthread_* symbols are
  included in the library (problem only seen on mips and mipsel).
  Closes: #253629
* debian/control: make libpcsclite-dev and libpcsclite1 at Priority:
  optional so that other packages at Priority: optional can use them.
  Closes: #249374

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/reader.conf.5.in
 
1
.\" Process this file with
 
2
.\" groff -man -Tascii reader_conf.8
 
3
.\"
 
4
.TH READER_CONF 8 "April 2004" Linux "User Manual"
 
5
.SH NAME
 
6
reader.conf - configuration file for pcscd readers' drivers
 
7
.SH DESCRIPTION
 
8
The
 
9
.I @confdir@/reader.conf
 
10
file contains configuration informations for serial and (some) PCMCIA
 
11
smart card readers.
 
12
 
 
13
USB readers SHALL NOT be configured using this file.
 
14
.B pcscd
 
15
uses another mechanism to automatically load USB drivers.
 
16
.SH SYNTAX
 
17
The
 
18
.I @confdir@/reader.conf
 
19
is a regular text file. Each reader must be defined by four fields:
 
20
 
 
21
 FRIENDLYNAME     TEXT_STRING
 
22
 DEVICENAME       FILENAME
 
23
 LIBPATH          FILENAME
 
24
 CHANNELID        NUMBER
 
25
 
 
26
The "FRIENDLYNAME" field is an arbitrary text used to identify the
 
27
reader. This text is displayed by commands like
 
28
.BR pcsc_scan (1)
 
29
that prints the names of all the connected and detected readers.
 
30
 
 
31
The "DEVICENAME" field was not used for old drivers (using the IFD
 
32
handler version 2.0 or previous). It is now (IFD handler version 3.0) used
 
33
to identify the physical port on which the reader is connected. This
 
34
is the device name of this port. It is dependant of the OS kernel. The
 
35
first serial port device is called
 
36
.I /dev/ttyS0
 
37
under Linux and
 
38
.I /dev/cuaa0
 
39
under FreeBSD.
 
40
 
 
41
The "LIBPATH" field is the filename of the driver code. The driver is
 
42
a dynamically loaded piece of code (generaly a 
 
43
.I drivername.so*
 
44
file).
 
45
 
 
46
The "CHANNELID" is no more used for recent drivers (IFD handler 3.0) and
 
47
has been superseeded by "DEVICENAME". If you have an old driver this
 
48
field is used to indicate the port to use. You should read your driver
 
49
documentation to know what information is needed here. It should be the
 
50
serial port number for a serial reader.
 
51
.SH EXAMPLE
 
52
 # Gemplus GemPCTwin reader with serial communication
 
53
 # connected to the first serial port
 
54
 FRIENDLYNAME      "GemPCTwin serial"
 
55
 DEVICENAME        /dev/ttyS0
 
56
 LIBPATH           @usbdropdir@/serial/libccidtwin.so.0.4.1
 
57
 CHANNELID         1
 
58
.SH DEBUGGING
 
59
In order to set up your
 
60
.I @confdir@/reader.conf
 
61
file correctly you may want to have debug messages from
 
62
.BR pcscd .
 
63
I recommand you to start
 
64
.B pscsd
 
65
in the foreground using:
 
66
 # pcscd --foreground
 
67
 
 
68
If everything seems OK you can use the
 
69
.B pcsc_scan
 
70
command to print the list of correctly detected readers and try to get
 
71
the ATR of your smart cards.
 
72
.SH AUTHOR
 
73
Ludovic Rousseau <ludovic.rousseau@free.fr>
 
74
.SH SEE ALSO
 
75
.BR pcscd (8),
 
76
.BR pcsc_scan (1)