VivoKey/vsmartcard
7
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity

- update on ccid documentation

Browse Source 
- rebuilding documentation when any *.in file changes


git-svn-id: https://vsmartcard.svn.sourceforge.net/svnroot/vsmartcard@613 96b47cad-a561-4643-ad3b-153ac7d7599c
This commit is contained in:
frankmorgner
2011-11-03 22:17:53 +00:00
parent 9f68d18eef
commit c1a94800cd
6 changed files with 74 additions and 38 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
ccid/doc/Makefile.am
View File

@@ -15,7 +15,7 @@ do_subst = sed \
EXTRA_DIST = README.rst.in README.rst autotools.rst autotools.rst.in questions.rst questions.rst.in EXTRA_DIST = README.rst.in README.rst autotools.rst autotools.rst.in questions.rst questions.rst.in
doc: doc: *.in
$(do_subst) < autotools.rst.in > autotools.rst $(do_subst) < autotools.rst.in > autotools.rst
$(do_subst) < questions.rst.in > questions.rst $(do_subst) < questions.rst.in > questions.rst
$(do_subst) < README.rst.in > README.rst $(do_subst) < README.rst.in > README.rst

52
ccid/doc/README.rst
View File

@@ -4,6 +4,8 @@
.. _GadgetFS: http://www.linux-usb.org/gadget/ .. _GadgetFS: http://www.linux-usb.org/gadget/
.. _libccid: http://pcsclite.alioth.debian.org/ccid.html .. _libccid: http://pcsclite.alioth.debian.org/ccid.html
.. |npa| replace:: :ref:`npa`
******************************************************************************** ********************************************************************************
CCID Emulator CCID Emulator
@@ -16,32 +18,48 @@ 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 a PCSC Welcome to the CCID Emulator. The purpose of the CCID Emulator is to forward
smartcard reader as a standard USB CCID reader. If the host system is in USB a PC/SC smartcard reader as a standard USB CCID reader. If the machine running
device mode, the CCID Emulator forwards the local reader via USB to another the CCID Emulator is in USB device mode, a local reader is forwareded via USB
device. If in USB host mode, the CCID Emulator virtually plugges in a USB CCID to another machine. If in USB host mode, a USB CCID reader is virtually plugged
reader to the host system. the CCID Emulator has support for Password into the machine running the CCID Emulator. Applications on Windows and
Authenticated Connection Establishment (PACE) using OpenPACE Unix-like systems can access the CCID Emulator through PC/SC as if it were a
(http://sourceforge.net/projects/openpace/). real smart card reader.
The CCID Emulator is implemented using GadgetFS_. Some fragments of the source code The CCID Emulator accesses a smart card through a local reader. Simple
are based on the GadgetFS example and on the source code of the OpenSC_ tools. commands such as transmitting an APDU (``SCardTransmit`` and accordingly
``PC_to_RDR_XfrBlock``) are directly forwarded to the local reader/smart card.
CCID Emulator can perform secure PIN verification and modification
(``FEATURE_VERIFY_PIN_DIRECT`` or ``FEATURE_MODIFY_PIN_DIRECT`` and accordingly
``PC_to_RDR_Secure``). Moreover the CCID Emulator has support the for Password
Authenticated Connection Establishment (PACE) using |npa|
(``FEATURE_EXECUTE_PACE``). Thus CCID Emulator can be used with the German
identity card ("neuer Personalausweis", nPA) similar to a "Standardleser"
(CAT-S) or "Komfortleser" (CAT-K).
The 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_
tools.
.. include:: autotools.rst .. include:: autotools.rst
The CCID Emulator following dependencies: Running the CCID Emulator has the following dependencies:
- Linux Kernel with GadgetFS_ - Linux Kernel with GadgetFS_
- OpenSC_ - OpenSC_
- :ref:`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
needs a usable PC/SC middleware with USB CCID driver. This is the case for most
modern Windows and Unix-like systems by default.
----------------- -----------------
Hints on GadgetFS Hints on GadgetFS
----------------- -----------------
To create an USB Gadget in both USB host and USB client mode, you need to load To create a USB Gadget in both USB host and USB client mode, you need to load
the kernel module :program:`gadgetfs`. A guide focused on Debian based systems to run the kernel module :program:`gadgetfs`. A guide focused on Debian based systems to run
and compile :program:`gadgetfs`, you can find `here and compile :program:`gadgetfs`, you can find `here
<http://wiki.openmoko.org/wiki/Building_Gadget_USB_Module>`_. <http://wiki.openmoko.org/wiki/Building_Gadget_USB_Module>`_.
@@ -60,11 +78,11 @@ loading the module, you maybe want to check out `this patch
Hints on OpenSC Hints on OpenSC
--------------- ---------------
Without :ref:`npa` the CCID Emulator links against libopensc, which is discouraged and hindered since OpenSC Without the |npa| the CCID Emulator links against libopensc, which is
version >= 0.12. (We really need to get rid of this dependency or integrate discouraged and hindered since OpenSC version >= 0.12. (We really need to get
better into the OpenSC-framework.) You need the OpenSC components to be rid of this dependency or integrate better into the OpenSC-framework.) You need
installed (especially :file:`libopensc.so`). Here is an example of how to get the the OpenSC components to be installed (especially :file:`libopensc.so`). Here
standard installation of OpenSC_:: is an example of how to get the standard installation of OpenSC_::
PREFIX=/tmp/install PREFIX=/tmp/install
OPENSC=opensc OPENSC=opensc

52
ccid/doc/README.rst.in
View File

@@ -4,6 +4,8 @@
.. _GadgetFS: http://www.linux-usb.org/gadget/ .. _GadgetFS: http://www.linux-usb.org/gadget/
.. _libccid: http://pcsclite.alioth.debian.org/ccid.html .. _libccid: http://pcsclite.alioth.debian.org/ccid.html
.. |npa| replace:: :ref:`npa`
******************************************************************************** ********************************************************************************
@PACKAGE_NAME@ @PACKAGE_NAME@
@@ -16,32 +18,48 @@
:Tested Platforms: :Tested Platforms:
Linux (Debian, Ubuntu, OpenMoko) Linux (Debian, Ubuntu, OpenMoko)
Welcome to the @PACKAGE_NAME@. The purpose of the @PACKAGE_NAME@ is to forward a PCSC Welcome to the @PACKAGE_NAME@. The purpose of the @PACKAGE_NAME@ is to forward
smartcard reader as a standard USB CCID reader. If the host system is in USB a PC/SC smartcard reader as a standard USB CCID reader. If the machine running
device mode, the @PACKAGE_NAME@ forwards the local reader via USB to another the @PACKAGE_NAME@ is in USB device mode, a local reader is forwareded via USB
device. If in USB host mode, the @PACKAGE_NAME@ virtually plugges in a USB CCID to another machine. If in USB host mode, a USB CCID reader is virtually plugged
reader to the host system. the @PACKAGE_NAME@ has support for Password into the machine running the @PACKAGE_NAME@. Applications on Windows and
Authenticated Connection Establishment (PACE) using OpenPACE Unix-like systems can access the @PACKAGE_NAME@ through PC/SC as if it were a
(http://sourceforge.net/projects/openpace/). real smart card reader.
The @PACKAGE_NAME@ is implemented using GadgetFS_. Some fragments of the source code The @PACKAGE_NAME@ accesses a smart card through a local reader. Simple
are based on the GadgetFS example and on the source code of the OpenSC_ tools. commands such as transmitting an APDU (``SCardTransmit`` and accordingly
``PC_to_RDR_XfrBlock``) are directly forwarded to the local reader/smart card.
@PACKAGE_NAME@ can perform secure PIN verification and modification
(``FEATURE_VERIFY_PIN_DIRECT`` or ``FEATURE_MODIFY_PIN_DIRECT`` and accordingly
``PC_to_RDR_Secure``). Moreover the @PACKAGE_NAME@ has support the for Password
Authenticated Connection Establishment (PACE) using |npa|
(``FEATURE_EXECUTE_PACE``). Thus @PACKAGE_NAME@ can be used with the German
identity card ("neuer Personalausweis", nPA) similar to a "Standardleser"
(CAT-S) or "Komfortleser" (CAT-K).
The @PACKAGE_NAME@ is implemented using GadgetFS_. Some fragments of the source
code are based on the GadgetFS example and on the source code of the OpenSC_
tools.
.. include:: autotools.rst .. include:: autotools.rst
The @PACKAGE_NAME@ following dependencies: Running the @PACKAGE_NAME@ has the following dependencies:
- Linux Kernel with GadgetFS_ - Linux Kernel with GadgetFS_
- OpenSC_ - OpenSC_
- :ref:`npa` (only if support for PACE is enabled) - |npa| (only if support for PACE is enabled)
Whereas using the @PACKAGE_NAME@ 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
modern Windows and Unix-like systems by default.
----------------- -----------------
Hints on GadgetFS Hints on GadgetFS
----------------- -----------------
To create an USB Gadget in both USB host and USB client mode, you need to load To create a USB Gadget in both USB host and USB client mode, you need to load
the kernel module :program:`gadgetfs`. A guide focused on Debian based systems to run the kernel module :program:`gadgetfs`. A guide focused on Debian based systems to run
and compile :program:`gadgetfs`, you can find `here and compile :program:`gadgetfs`, you can find `here
<http://wiki.openmoko.org/wiki/Building_Gadget_USB_Module>`_. <http://wiki.openmoko.org/wiki/Building_Gadget_USB_Module>`_.
@@ -60,11 +78,11 @@ loading the module, you maybe want to check out `this patch
Hints on OpenSC Hints on OpenSC
--------------- ---------------
Without :ref:`npa` the @PACKAGE_NAME@ links against libopensc, which is discouraged and hindered since OpenSC Without the |npa| the @PACKAGE_NAME@ links against libopensc, which is
version >= 0.12. (We really need to get rid of this dependency or integrate discouraged and hindered since OpenSC version >= 0.12. (We really need to get
better into the OpenSC-framework.) You need the OpenSC components to be rid of this dependency or integrate better into the OpenSC-framework.) You need
installed (especially :file:`libopensc.so`). Here is an example of how to get the the OpenSC components to be installed (especially :file:`libopensc.so`). Here
standard installation of OpenSC_:: is an example of how to get the standard installation of OpenSC_::
PREFIX=/tmp/install PREFIX=/tmp/install
OPENSC=opensc OPENSC=opensc

2
npa/doc/Makefile.am
View File

@@ -15,7 +15,7 @@ do_subst = sed \
EXTRA_DIST = README.rst.in README.rst Doxyfile.in example.c autotools.rst autotools.rst.in questions.rst questions.rst.in EXTRA_DIST = README.rst.in README.rst Doxyfile.in example.c autotools.rst autotools.rst.in questions.rst questions.rst.in
doc: $(top_srcdir)/src/npa/*.h doc: $(top_srcdir)/src/npa/*.h *.in
$(do_subst) < Doxyfile.in > Doxyfile $(do_subst) < Doxyfile.in > Doxyfile
$(DOXYGEN) Doxyfile $(DOXYGEN) Doxyfile
touch api.rst touch api.rst

2
pcsc-relay/doc/Makefile.am
View File

@@ -15,7 +15,7 @@ do_subst = sed \
EXTRA_DIST = README.rst.in README.rst autotools.rst.in questions.rst.in autotools.rst questions.rst EXTRA_DIST = README.rst.in README.rst autotools.rst.in questions.rst.in autotools.rst questions.rst
doc: doc: *.in
$(do_subst) < autotools.rst.in > autotools.rst $(do_subst) < autotools.rst.in > autotools.rst
$(do_subst) < questions.rst.in > questions.rst $(do_subst) < questions.rst.in > questions.rst
$(do_subst) < README.rst.in > README.rst $(do_subst) < README.rst.in > README.rst

2
virtualsmartcard/doc/Makefile.am
View File

@@ -19,7 +19,7 @@ EXTRA_DIST = README.rst.in README.rst autotools.rst.in questions.rst.in autotool
dist_noinst_SCRIPTS = generate_modules.py dist_noinst_SCRIPTS = generate_modules.py
doc: $(top_srcdir)/src/vpicc/virtualsmartcard/*.py $(top_srcdir)/src/vpicc/virtualsmartcard/cards/*.py generate_modules.py doc: $(top_srcdir)/src/vpicc/virtualsmartcard/*.py $(top_srcdir)/src/vpicc/virtualsmartcard/cards/*.py generate_modules.py *.in
$(do_subst) < autotools.rst.in > autotools.rst $(do_subst) < autotools.rst.in > autotools.rst
$(do_subst) < questions.rst.in > questions.rst $(do_subst) < questions.rst.in > questions.rst
$(do_subst) < README.rst.in > README.rst $(do_subst) < README.rst.in > README.rst