updated documentation
git-svn-id: https://vsmartcard.svn.sourceforge.net/svnroot/vsmartcard@743 96b47cad-a561-4643-ad3b-153ac7d7599c
This commit is contained in:
frankmorgner
@@ -1,4 +1,5 @@
|
||||
do_subst = sed \
|
||||
-e 's,[@]PACKAGE[@],$(PACKAGE),g' \
|
||||
-e 's,[@]PACKAGE_NAME[@],$(PACKAGE_NAME),g' \
|
||||
-e 's,[@]PACKAGE_TARNAME[@],$(PACKAGE_TARNAME),g' \
|
||||
-e 's,[@]PACKAGE_BUGREPORT[@],$(PACKAGE_BUGREPORT),g' \
|
||||
|
||||
@@ -1,52 +1,58 @@
|
||||
.. highlight:: sh
|
||||
|
||||
.. _libnfc: http://www.libnfc.org/
|
||||
.. _OpenPICC: http://www.openpcd.org/OpenPICC
|
||||
.. _PCSC-lite: http://pcsclite.alioth.debian.org/
|
||||
|
||||
.. _pcsc-relay:
|
||||
|
||||
********************************************************************************
|
||||
PC/SC Relay
|
||||
********************************************************************************
|
||||
|
||||
:Authors:
|
||||
- Dominik Oepen <oepen@informatik.hu-berlin.de>
|
||||
- Frank Morgner <morgner@informatik.hu-berlin.de>
|
||||
- Dominik Oepen <oepen@informatik.hu-berlin.de>
|
||||
:License:
|
||||
GPL version 3
|
||||
:Tested Platforms:
|
||||
Linux (Debian, Ubuntu, OpenMoko)
|
||||
:Potential Platforms:
|
||||
- Windows
|
||||
- Unix-like operating systems (Mac OS, Solaris, BSD, ...)
|
||||
- Linux (Debian, Ubuntu, OpenMoko)
|
||||
:Potential Platforms:
|
||||
Unix-like operating systems (Mac OS, Solaris, BSD, ...)
|
||||
|
||||
Welcome to pcsc-relay. The purpose of pcsc-relay is to forward APDUs from the
|
||||
OpenPICC or from a libnfc device to a smart card via the PCSC middleware. You
|
||||
can use this program in combination with the virtual smart card to emulate a
|
||||
ISO/IEC 14443 smart card.
|
||||
Welcome to PC/SC Relay. The purpose of PC/SC Relay is to relay a smart
|
||||
card using an contact-less interface. Currently the following contact-less
|
||||
backends:
|
||||
|
||||
- libnfc_
|
||||
- OpenPICC_
|
||||
|
||||
Command APDUs are received with the contact-less interface and forwarded to an
|
||||
existing smart card via PC/SC. The Response APDUs are then sent back via RFID.
|
||||
You can use PC/SC Relay in combination with the :ref:`vicc` to completely
|
||||
emulate an ISO/IEC 14443 smart card.
|
||||
|
||||
.. note::
|
||||
This software can actually be used in a relay attack allowing full access
|
||||
to the card... `We discussed the impact especially on the German identity
|
||||
to the card. `We discussed the impact especially on the German identity
|
||||
card
|
||||
<http://media.ccc.de/browse/congress/2010/27c3-4297-de-die_gesamte_technik_ist_sicher.html>`_,
|
||||
but it generally concerns *all NFC smart cards*.
|
||||
but it generally concerns *all* contact-less smart cards.
|
||||
|
||||
|
||||
.. include:: autotools.rst
|
||||
|
||||
pcsc-relay has the following dependencies:
|
||||
PC/SC Relay has the following dependencies:
|
||||
|
||||
- PC/SC middleware
|
||||
- libnfc_
|
||||
|
||||
.. program-output:: pcsc-relay --help
|
||||
|
||||
|
||||
---------------
|
||||
Hints on libnfc
|
||||
---------------
|
||||
|
||||
pcsc-relay links against libnfc_. Here is an example of how to get the standard
|
||||
PC/SC Relay links against libnfc_. Here is an example of how to get the standard
|
||||
installation of the latter::
|
||||
|
||||
PREFIX=/tmp/install
|
||||
@@ -58,9 +64,9 @@ installation of the latter::
|
||||
make
|
||||
make install
|
||||
|
||||
Building pcsc-relay with libnfc_ is done best using :command:`pkg-config`. The file
|
||||
Building PC/SC Relay with libnfc_ is done best using :command:`pkg-config`. The file
|
||||
:file:`libnfc.pc` should be located in ``$INSTALL/lib/pkgconfig``. Here is how to
|
||||
configure pcsc-relay to use it::
|
||||
configure PC/SC Relay to use it::
|
||||
|
||||
./configure PKG_CONFIG_PATH=$PREFIX/lib/pkgconfig
|
||||
|
||||
@@ -69,12 +75,21 @@ configure pcsc-relay to use it::
|
||||
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.
|
||||
A PC/SC middleware 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 PC/SC 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 PC/SC Relay.
|
||||
|
||||
|
||||
=====
|
||||
Usage
|
||||
=====
|
||||
|
||||
.. program-output:: pcsc-relay --help
|
||||
|
||||
|
||||
.. include:: questions.rst
|
||||
|
||||
@@ -1,52 +1,58 @@
|
||||
.. highlight:: sh
|
||||
|
||||
.. _libnfc: http://www.libnfc.org/
|
||||
.. _OpenPICC: http://www.openpcd.org/OpenPICC
|
||||
.. _PCSC-lite: http://pcsclite.alioth.debian.org/
|
||||
|
||||
.. _pcsc-relay:
|
||||
|
||||
********************************************************************************
|
||||
@PACKAGE_NAME@
|
||||
********************************************************************************
|
||||
|
||||
:Authors:
|
||||
- Dominik Oepen <oepen@informatik.hu-berlin.de>
|
||||
- Frank Morgner <morgner@informatik.hu-berlin.de>
|
||||
- Dominik Oepen <oepen@informatik.hu-berlin.de>
|
||||
:License:
|
||||
GPL version 3
|
||||
:Tested Platforms:
|
||||
Linux (Debian, Ubuntu, OpenMoko)
|
||||
:Potential Platforms:
|
||||
- Windows
|
||||
- Unix-like operating systems (Mac OS, Solaris, BSD, ...)
|
||||
- Linux (Debian, Ubuntu, OpenMoko)
|
||||
:Potential Platforms:
|
||||
Unix-like operating systems (Mac OS, Solaris, BSD, ...)
|
||||
|
||||
Welcome to pcsc-relay. The purpose of pcsc-relay is to forward APDUs from the
|
||||
OpenPICC or from a libnfc device to a smart card via the PCSC middleware. You
|
||||
can use this program in combination with the virtual smart card to emulate a
|
||||
ISO/IEC 14443 smart card.
|
||||
Welcome to @PACKAGE_NAME@. The purpose of @PACKAGE_NAME@ is to relay a smart
|
||||
card using an contact-less interface. Currently the following contact-less
|
||||
backends:
|
||||
|
||||
- libnfc_
|
||||
- OpenPICC_
|
||||
|
||||
Command APDUs are received with the contact-less interface and forwarded to an
|
||||
existing smart card via PC/SC. The Response APDUs are then sent back via RFID.
|
||||
You can use @PACKAGE_NAME@ in combination with the :ref:`vicc` to completely
|
||||
emulate an ISO/IEC 14443 smart card.
|
||||
|
||||
.. note::
|
||||
This software can actually be used in a relay attack allowing full access
|
||||
to the card... `We discussed the impact especially on the German identity
|
||||
to the card. `We discussed the impact especially on the German identity
|
||||
card
|
||||
<http://media.ccc.de/browse/congress/2010/27c3-4297-de-die_gesamte_technik_ist_sicher.html>`_,
|
||||
but it generally concerns *all NFC smart cards*.
|
||||
but it generally concerns *all* contact-less smart cards.
|
||||
|
||||
|
||||
.. include:: autotools.rst
|
||||
|
||||
pcsc-relay has the following dependencies:
|
||||
@PACKAGE_NAME@ has the following dependencies:
|
||||
|
||||
- PC/SC middleware
|
||||
- libnfc_
|
||||
|
||||
.. program-output:: pcsc-relay --help
|
||||
|
||||
|
||||
---------------
|
||||
Hints on libnfc
|
||||
---------------
|
||||
|
||||
pcsc-relay links against libnfc_. Here is an example of how to get the standard
|
||||
@PACKAGE_NAME@ links against libnfc_. Here is an example of how to get the standard
|
||||
installation of the latter::
|
||||
|
||||
PREFIX=/tmp/install
|
||||
@@ -58,9 +64,9 @@ installation of the latter::
|
||||
make
|
||||
make install
|
||||
|
||||
Building pcsc-relay with libnfc_ is done best using :command:`pkg-config`. The file
|
||||
Building @PACKAGE_NAME@ with libnfc_ is done best using :command:`pkg-config`. The file
|
||||
:file:`libnfc.pc` should be located in ``$INSTALL/lib/pkgconfig``. Here is how to
|
||||
configure pcsc-relay to use it::
|
||||
configure @PACKAGE_NAME@ to use it::
|
||||
|
||||
./configure PKG_CONFIG_PATH=$PREFIX/lib/pkgconfig
|
||||
|
||||
@@ -69,12 +75,21 @@ configure pcsc-relay to use it::
|
||||
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.
|
||||
A PC/SC middleware 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 @PACKAGE_NAME@ 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 @PACKAGE_NAME@.
|
||||
|
||||
|
||||
=====
|
||||
Usage
|
||||
=====
|
||||
|
||||
.. program-output:: @PACKAGE@ --help
|
||||
|
||||
|
||||
.. include:: questions.rst
|
||||
|
||||
Reference in New Issue
Block a user