updated documentation

git-svn-id: https://vsmartcard.svn.sourceforge.net/svnroot/vsmartcard@735 96b47cad-a561-4643-ad3b-153ac7d7599c
This commit is contained in:
frankmorgner
2012-04-09 13:36:17 +00:00
parent 54f9311de8
commit 414a011b80
2 changed files with 20 additions and 20 deletions

View File

@@ -8,7 +8,7 @@
******************************************************************************** ********************************************************************************
CCID Emulator USB CCID Emulator
******************************************************************************** ********************************************************************************
:Author: :Author:
@@ -18,39 +18,39 @@ CCID Emulator
:Tested Platforms: :Tested Platforms:
Linux (Debian, Ubuntu, OpenMoko) Linux (Debian, Ubuntu, OpenMoko)
Welcome to the CCID Emulator. The purpose of the CCID Emulator is to forward Welcome to the USB CCID Emulator. The purpose of the USB CCID Emulator is to forward
a PC/SC smartcard reader as a standard USB CCID reader. If the machine running a PC/SC smartcard reader as a standard USB CCID reader. If the machine running
the CCID Emulator is in USB device mode, a local reader is forwareded via USB the USB CCID Emulator is in USB device mode, a local reader is forwareded via USB
to another machine. If in USB host mode, a USB CCID reader is virtually plugged to another machine. If in USB host mode, a USB CCID reader is virtually plugged
into the machine running the CCID Emulator. Applications on Windows and into the machine running the USB CCID Emulator. Applications on Windows and
Unix-like systems can access the CCID Emulator through PC/SC as if it were a Unix-like systems can access the USB CCID Emulator through PC/SC as if it were a
real smart card reader. real smart card reader.
The CCID Emulator accesses a smart card through a local reader. Simple The USB CCID Emulator accesses a smart card through a local reader. Simple
commands such as transmitting an APDU (``SCardTransmit`` and accordingly commands such as transmitting an APDU (``SCardTransmit`` and accordingly
``PC_to_RDR_XfrBlock``) are directly forwarded to the local reader/smart card. ``PC_to_RDR_XfrBlock``) are directly forwarded to the local reader/smart card.
CCID Emulator can perform secure PIN verification and modification USB CCID Emulator can perform secure PIN verification and modification
(``FEATURE_VERIFY_PIN_DIRECT`` or ``FEATURE_MODIFY_PIN_DIRECT`` and accordingly (``FEATURE_VERIFY_PIN_DIRECT`` or ``FEATURE_MODIFY_PIN_DIRECT`` and accordingly
``PC_to_RDR_Secure``). Moreover the CCID Emulator has support the for Password ``PC_to_RDR_Secure``). Moreover the USB CCID Emulator has support the for Password
Authenticated Connection Establishment (PACE) using |npa| Authenticated Connection Establishment (PACE) using |npa|
(``FEATURE_EXECUTE_PACE``). Thus CCID Emulator can be used with the German (``FEATURE_EXECUTE_PACE``). Thus USB CCID Emulator can be used with the German
identity card ("neuer Personalausweis", nPA) similar to a "Standardleser" identity card ("neuer Personalausweis", nPA) similar to a "Standardleser"
(CAT-S) or "Komfortleser" (CAT-K). (CAT-S) or "Komfortleser" (CAT-K).
The CCID Emulator is implemented using GadgetFS_. Some fragments of the source The USB CCID Emulator is implemented using GadgetFS_. Some fragments of the source
code are based on the GadgetFS example and on the source code of the OpenSC_ code are based on the GadgetFS example and on the source code of the OpenSC_
tools. tools.
.. include:: autotools.rst .. include:: autotools.rst
Running the CCID Emulator has the following dependencies: Running the USB CCID Emulator has the following dependencies:
- Linux Kernel with GadgetFS_ - Linux Kernel with GadgetFS_
- OpenSC_ - OpenSC_
- |npa| (only if support for PACE is enabled) - |npa| (only if support for PACE is enabled)
Whereas using the CCID Emulator on the host system as smart card reader only Whereas using the USB CCID Emulator on the host system as smart card reader only
needs a usable PC/SC middleware with USB CCID driver. This is the case for most needs a usable PC/SC middleware with USB CCID driver. This is the case for most
modern Windows and Unix-like systems by default. modern Windows and Unix-like systems by default.
@@ -78,7 +78,7 @@ loading the module, you maybe want to check out `this patch
Hints on OpenSC Hints on OpenSC
--------------- ---------------
Without the |npa| the CCID Emulator links against libopensc, which is Without the |npa| the USB CCID Emulator links against libopensc, which is
discouraged and hindered since OpenSC version >= 0.12. (We really need to get discouraged and hindered since OpenSC version >= 0.12. (We really need to get
rid of this dependency or integrate better into the OpenSC-framework.) You need rid of this dependency or integrate better into the OpenSC-framework.) You need
the OpenSC components to be installed (especially :file:`libopensc.so`). Here the OpenSC components to be installed (especially :file:`libopensc.so`). Here
@@ -94,7 +94,7 @@ is an example of how to get the standard installation of OpenSC_::
make install make install
Now :file:`libopensc.so` should be located in ``$PREFIX/lib``. Here is how to Now :file:`libopensc.so` should be located in ``$PREFIX/lib``. Here is how to
configure the CCID Emulator to use it:: configure the USB CCID Emulator to use it::
./configure OPENSC_LIBS="-L$PREFIX/lib -lopensc" ./configure OPENSC_LIBS="-L$PREFIX/lib -lopensc"
@@ -103,16 +103,16 @@ configure the CCID Emulator to use it::
Usage Usage
===== =====
The CCID Emulator has various command line options to customize the appearance on The USB CCID Emulator has various command line options to customize the appearance on
the USB host. In order to run the CCID Emulator GadgetFS_ must be loaded and the USB host. In order to run the USB CCID Emulator GadgetFS_ must be loaded and
mounted. The CCID Emulator is compatible with the unix driver libccid_ and the mounted. The USB CCID Emulator is compatible with the unix driver libccid_ and the
windows smart card driver. To initialize PACE using the PC/SC API you need to windows smart card driver. To initialize PACE using the PC/SC API you need to
patch libccid and pcsc-lite (see directory patches). patch libccid and pcsc-lite (see directory patches).
.. program-output:: ccid-emulator --help .. program-output:: ccid-emulator --help
cats-test can be used to test the PACE capabilities of a smart card reader with cats-test can be used to test the PACE capabilities of a smart card reader with
PACE support (such as the CCID Emulator or any other "Standardleser" CAT-S or PACE support (such as the USB CCID Emulator or any other "Standardleser" CAT-S or
"Komfortleser" CAT-C) via PC/SC. "Komfortleser" CAT-C) via PC/SC.
.. program-output:: cats-test .. program-output:: cats-test

View File

@@ -4,7 +4,7 @@
Installation Installation
============= =============
The CCID Emulator uses the GNU Build System to compile and install. If you are The USB CCID Emulator uses the GNU Build System to compile and install. If you are
unfamiliar with it, please have a look at :file:`INSTALL`. If you have a look unfamiliar with it, please have a look at :file:`INSTALL`. If you have a look
around and can not find it, you are probably working bleeding edge in the around and can not find it, you are probably working bleeding edge in the
repository. Run the following command in :file:`ccid-emulator` to repository. Run the following command in :file:`ccid-emulator` to
@@ -13,7 +13,7 @@ get the missing standard auxiliary files::
autoreconf -i autoreconf -i
To configure (:command:`configure --help` lists possible options), build and To configure (:command:`configure --help` lists possible options), build and
install the CCID Emulator now do the following:: install the USB CCID Emulator now do the following::
./configure ./configure
make make