| 1 |
Title : PCSC Lite |
| 2 |
Authors : David Corcoran, Ludovic Rousseau |
| 3 |
Version : 1.2.9-beta10 |
| 4 |
License : See file COPYING |
| 5 |
Document: docs/pcsc-lite.pdf |
| 6 |
docs/ifdhandler-3.pdf |
| 7 |
Requires: A C compiler |
| 8 |
Make, linker tools |
| 9 |
Lex (Lexical Analyzer). |
| 10 |
|
| 11 |
Tested Platforms: |
| 12 |
Linux 2.4 (Redhat 7.1, Suse 7.1/7.2, Debian 3.0) |
| 13 |
Mac OS X 10.2, 10.3 |
| 14 |
FreeBSD, NetBSD, OpenBSD |
| 15 |
Solaris 8 / 9 |
| 16 |
Tru64 UNIX 5.1B |
| 17 |
AIX 4.3, 5.2 |
| 18 |
HP-UX 11 |
| 19 |
|
| 20 |
Welcome to PCSC Lite. The purpose of PCSC Lite is to |
| 21 |
provide a Windows(R) SCard interface in a very small form factor for |
| 22 |
communicating to smart cards and readers. PCSC Lite can be compiled |
| 23 |
directly to a desired reader driver or can be used to dynamically |
| 24 |
allocate/deallocate reader drivers at runtime (default). |
| 25 |
|
| 26 |
PCSC Lite uses the same winscard API as used under Windows(R). |
| 27 |
|
| 28 |
For security aware persons please read the SECURITY file on possible |
| 29 |
vulnerabilities to pcsclite, how you can fix some, and how some will |
| 30 |
be fixed. |
| 31 |
|
| 32 |
For information on how to install driver please read the DRIVERS file. |
| 33 |
|
| 34 |
Memory cards are supported through MCT specifications which is an APDU |
| 35 |
like manner sent normally through the SCardTransmit() function. This |
| 36 |
functionality is done in the driver. |
| 37 |
|
| 38 |
INSTALLATION: |
| 39 |
|
| 40 |
Installation is simple. Type ./configure and then make and make install. |
| 41 |
Options: |
| 42 |
|
| 43 |
./configure |
| 44 |
|
| 45 |
--enable-libusb Enable USB libusb support |
| 46 |
(on Linux, *BSD, etc.). |
| 47 |
--enable-usbdropdir=DIR directory containing USB drivers |
| 48 |
(default /usr/local/pcsc/drivers) |
| 49 |
--disable-musclecarddebug Disable MuscleCard debugging messages |
| 50 |
--enable-debugatr Enable ATR parsing debug output |
| 51 |
--enable-scf use SCF for reader support |
| 52 |
--prefix=location Install to <location> |
| 53 |
--enable-confdir=DIR Use DIR as the configuration directory |
| 54 |
(/etc by default) |
| 55 |
--enable-runpid=FILE Store the daemon pid in file FILE |
| 56 |
--enable-ipcdir=DIR directory containing IPC files |
| 57 |
(default /var/run) |
| 58 |
|
| 59 |
|
| 60 |
By running pcscd under a privileged account you can link to |
| 61 |
libpcsclite.so and it will act as a client to the pcscd allowing multiple |
| 62 |
applications to be run under non-privileged accounts. |
| 63 |
|
| 64 |
Then type "make install" to copy the libraries to /usr/local/lib. If you |
| 65 |
choose not to have your reader configuration file in /etc/reader.conf.d/ |
| 66 |
then use --enable-confdir=DIR |
| 67 |
|
| 68 |
You must be root to do make install in the default locations. |
| 69 |
|
| 70 |
Be sure to edit the /etc/reader.conf.d/my_reader.conf file for your |
| 71 |
reader to fit your needs and make sure your IFD Handler driver is |
| 72 |
located in the path specified as LIBRARYPATH in my_reader.conf. If you |
| 73 |
are using a reader with multiple smart card slots all you have to do is |
| 74 |
define a different FRIENDLYNAME in the my_reader.conf for each reader. |
| 75 |
Both will have the same information otherwise. |
| 76 |
|
| 77 |
USB users shall not use /etc/reader.conf.d/ to configure USB drivers. |
| 78 |
|
| 79 |
There is a test program with this package: |
| 80 |
|
| 81 |
testpcsc: Linked to libpcsclite. Must run /usr/local/pcsc/bin/pcscd |
| 82 |
and then ./testpcsc. pcscd must be run as root or a hardware |
| 83 |
privileged user. ./testpcsc can be run under any account. |
| 84 |
|
| 85 |
LIBUSB SUPPORT: |
| 86 |
Versions after 1.2.0 support libusb. Available on GNU/Linux and *BSD. |
| 87 |
|
| 88 |
If you do not have libusb (or do not want to use it) on your system you |
| 89 |
should use --disable-libusb. If you use --disable-libusb under Linux the |
| 90 |
old USB code will be used instead. |
| 91 |
|
| 92 |
In order to use dynamic driver loading, you need to supply a directory |
| 93 |
called "XXXX.bundle" in the usb dropdir directory (--enable-usbdropdir=PATH). |
| 94 |
Here, the string "XXXX" stands for an arbitrary driver name, like in |
| 95 |
"ifd-GemPC430.bundle". An example .bundle-directory can be found in the |
| 96 |
source distribution of the ifd-gempc driver |
| 97 |
(https://ifd-gempc.apdu.fr/) |
| 98 |
|
| 99 |
SOLARIS: |
| 100 |
Solaris PC/SC applications must link with -lsocket since |
| 101 |
the libraries are not statically linked. |
| 102 |
|
| 103 |
QUESTIONS: |
| 104 |
|
| 105 |
The API documentation is provided in PDF format under the docs |
| 106 |
directory. For questions, please email me at: |
| 107 |
<David Corcoran> [email protected] |
| 108 |
|
| 109 |
On some plateforms (GNU/Linux on mips and mipsel, FreeBSD and possibly |
| 110 |
other *BSD systems) you must use: |
| 111 |
$ ./configure LDFLAGS="-lpthread" |