You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

README 4.5 KiB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117
  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. Tested Platforms:
  11. Linux 2.4 (Redhat 7.1, Suse 7.1/7.2, Debian 3.0)
  12. Mac OS X 10.2, 10.3
  13. FreeBSD, NetBSD, OpenBSD
  14. Solaris 8 / 9
  15. Tru64 UNIX 5.1B
  16. AIX 4.3, 5.2
  17. HP-UX 11
  18. Welcome to PCSC Lite. The purpose of PCSC Lite is to
  19. provide a Windows(R) SCard interface in a very small form factor for
  20. communicating to smart cards and readers. PCSC Lite can be compiled
  21. directly to a desired reader driver or can be used to dynamically
  22. allocate/deallocate reader drivers at runtime (default).
  23. PCSC Lite uses the same winscard API as used under Windows(R).
  24. For security aware persons please read the SECURITY file on possible
  25. vulnerabilites to pcsclite, how you can fix some, and how some will
  26. be fixed.
  27. For information on how to install driver please read the DRIVERS file.
  28. Memory cards are supported through MCT specifications which is an APDU
  29. like manner sent normally through the SCardTransmit() function. This
  30. functionality is done in the driver.
  31. INSTALLATION:
  32. Installation is simple. Type ./configure and then make and make install.
  33. Options:
  34. ./configure
  35. --enable-libusb Enable USB libusb support
  36. (on Linux, *BSD, etc.).
  37. --enable-usbdropdir=DIR directory containing USB drivers
  38. (default /usr/local/pcsc/drivers)
  39. --disable-musclecarddebug Disable MuscleCard debugging messages
  40. --enable-debugatr Enable ATR parsing debug output
  41. --enable-scf use SCF for reader support
  42. --prefix=location Install to <location>
  43. --enable-confdir=DIR Use DIR as the configuration directory
  44. (/etc by default)
  45. --enable-runpid=FILE Store the daemon pid in file FILE
  46. --enable-ipcdir=DIR directory containing IPC files
  47. (default /var/run)
  48. By running pcscd under a priveledged account you can link to
  49. libpcsclite.so and it will act as a client to the pcscd allowing multiple
  50. applications to be run under non-priveledged accounts.
  51. Then type make install to copy etc/reader.conf to
  52. /etc/reader.conf and the libraries to /usr/local/lib. If you choose
  53. not to have your reader.conf in /etc then use --enable-confdir=DIR
  54. You must be root to do make install in the default locations.
  55. Be sure to edit the /etc/reader.conf file to fit your needs and make sure
  56. your IFD Handler driver is located in the path specified as LIBRARYPATH
  57. in reader.conf. If you are using a reader with multiple smart card slots
  58. all you have to do is define a different FRIENDLYNAME in the reader.conf
  59. for each reader. Both will have the same information otherwise.
  60. There is an config file generator in the utils directory. It is called
  61. installifd. You may use this to generate the /etc/reader.conf file.
  62. USB users shall not use /etc/reader.conf. pcscd will give
  63. a warning that the file does not exist or contain anything useful.
  64. There is a test program with this package:
  65. testpcsc: Linked to libpcsclite. Must run /usr/local/pcsc/bin/pcscd
  66. and then ./testpcsc. pcscd must be run as root or a hardware
  67. priveledged user. ./testpcsc can be run under any account.
  68. LIBUSB SUPPORT:
  69. Versions after 1.2.0 support libusb. Available on GNU/Linux and *BSD.
  70. If you do not have libusb (or do not want to use it) on your system you
  71. should use --disable-libusb. If you use --disable-libusb under Linux the
  72. old USB code will be used instead.
  73. In order to use dynamic driver loading, you need to supply a directory
  74. called "XXXX.bundle" in the usb dropdir directory (--enable-usbdropdir=PATH).
  75. Here, the string "XXXX" stands for an arbitrary driver name, like in
  76. "ifd-GemPC430.bundle". An example .bundle-directory can be found in the
  77. source distribution of the ifd-gempc driver
  78. (http://ludovic.rousseau.free.fr/softwares/ifd-GemPC/)
  79. SOLARIS:
  80. Solaris PC/SC applications must link with -lsocket since
  81. the libraries are not statically linked.
  82. QUESTIONS:
  83. The API documentation is provided in PDF format under the docs
  84. directory. For questions, please email me at:
  85. <David Corcoran> corcoran@musclecard.com
  86. On some plateforms (GNU/Linux on mips and mipsel, FreeBSD and possibly
  87. other *BSD suystems) you must use:
  88. $ ./configure LDFLAGS="-lpthread"
  89. $Id: README 6851 2014-02-14 15:43:32Z rousseau $