Debian Codegraph @

README

raw
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"