diff --git a/pcsc-relay/README b/pcsc-relay/README index a7af19a..a07cee5 100644 --- a/pcsc-relay/README +++ b/pcsc-relay/README @@ -1,3 +1,8 @@ +.. highlight:: sh + +.. _libnfc: http://www.libnfc.org/ +.. _PCSC-lite: http://pcsclite.alioth.debian.org/ + ********** pcsc-relay ********** @@ -13,12 +18,57 @@ can use this program in combination with the virtual smart card to emulate a ISO/IEC 14443 smart card. +============ Installation ------------- +============ -See file INSTALL. +pcsc-relay uses the GNU Build System to compile and install. If you are +unfamiliar with it, please have a look at the file ``INSTALL``. If you have a +look around and can not find it, you are probably working bleeding edge in the +repository. Run the following command in the pcsc-relay direcotry to get the +missing standard auxiliary files:: + + autoreconf -i +pcsc-relay has the following dependencies: +- PC/SC middleware +- libnfc_ + +--------------- +Hints on libnfc +--------------- + +pcsc-relay links against libnfc_. Here is an example of how to get the standard +installation of the latter:: + + PREFIX=/tmp/install + LIBNFC=libnfc + svn co http://libnfc.googlecode.com/svn/trunk $LIBNFC + cd $LIBNFC + autoreconf -i + ./configure --prefix=$PREFIX + make + make install + +Building pcsc-relay with libnfc_ is done best using ``pkg-config``. The file +``libnfc.pc`` should be located in ``$INSTALL/lib/pkgconfig``. Here is how to +configure pcsc-relay to use it:: + + ./configure PKG_CONFIG_PATH=$PREFIX/lib/pkgconfig + +------------------------- +Hints on PC/SC middleware +------------------------- + +PC/SC is included by default in most modern operating systems. On Unix-like +systems (Linux, OS X, Sun OS) it is realized by PCSC-Lite_. To compile +pcsc-relay you will need to install the PCSC-Lite headers from your +distribution. Windows also ships with a PC/SC middleware in form of the +Winscard module. Microsoft's developement environment Visual Studio includes +all necessary data for building pcsc-relay. + +--------- Questions ---------