more autotool magic
git-svn-id: https://vsmartcard.svn.sourceforge.net/svnroot/vsmartcard@599 96b47cad-a561-4643-ad3b-153ac7d7599c
This commit is contained in:
@@ -13,9 +13,10 @@ do_subst = sed \
|
|||||||
-e 's,[@]OPENSC_LIBS[@],$(OPENSC_LIBS),g' \
|
-e 's,[@]OPENSC_LIBS[@],$(OPENSC_LIBS),g' \
|
||||||
-e 's,[@]top_srcdir[@],$(top_srcdir),g'
|
-e 's,[@]top_srcdir[@],$(top_srcdir),g'
|
||||||
|
|
||||||
EXTRA_DIST = 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
|
||||||
|
|
||||||
.PHONY: doc
|
.PHONY: doc
|
||||||
doc:
|
doc:
|
||||||
$(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
|
||||||
|
|||||||
@@ -5,9 +5,9 @@
|
|||||||
.. _libccid: http://pcsclite.alioth.debian.org/ccid.html
|
.. _libccid: http://pcsclite.alioth.debian.org/ccid.html
|
||||||
|
|
||||||
|
|
||||||
*************
|
********************************************************************************
|
||||||
ccid-emulator
|
@PACKAGE_NAME@
|
||||||
*************
|
********************************************************************************
|
||||||
|
|
||||||
:Author:
|
:Author:
|
||||||
Frank Morgner <morgner@informatik.hu-berlin.de>
|
Frank Morgner <morgner@informatik.hu-berlin.de>
|
||||||
@@ -16,21 +16,21 @@ ccid-emulator
|
|||||||
:Tested Platforms:
|
:Tested Platforms:
|
||||||
Linux (Debian, Ubuntu, OpenMoko)
|
Linux (Debian, Ubuntu, OpenMoko)
|
||||||
|
|
||||||
Welcome to ccid-emulator. The purpose of ccid-emulator is to forward a PCSC
|
Welcome to the @PACKAGE_NAME@. The purpose of the @PACKAGE_NAME@ is to forward a PCSC
|
||||||
smartcard reader as a standard USB CCID reader. If the host system is in USB
|
smartcard reader as a standard USB CCID reader. If the host system is in USB
|
||||||
device mode, ccid-emulator forwards the local reader via USB to another
|
device mode, the @PACKAGE_NAME@ forwards the local reader via USB to another
|
||||||
device. If in USB host mode, ccid-emulator virtually plugges in a USB CCID
|
device. If in USB host mode, the @PACKAGE_NAME@ virtually plugges in a USB CCID
|
||||||
reader to the host system. ccid-emulator has support for Password
|
reader to the host system. the @PACKAGE_NAME@ has support for Password
|
||||||
Authenticated Connection Establishment (PACE) using OpenPACE
|
Authenticated Connection Establishment (PACE) using OpenPACE
|
||||||
(http://sourceforge.net/projects/openpace/).
|
(http://sourceforge.net/projects/openpace/).
|
||||||
|
|
||||||
ccid-emulator is implemented using GadgetFS_. Some fragments of the source code
|
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.
|
are based on the GadgetFS example and on the source code of the OpenSC_ tools.
|
||||||
|
|
||||||
|
|
||||||
.. include:: autotools.rst
|
.. include:: autotools.rst
|
||||||
|
|
||||||
ccid as the following dependencies:
|
The @PACKAGE_NAME@ following dependencies:
|
||||||
|
|
||||||
- Linux Kernel with GadgetFS_
|
- Linux Kernel with GadgetFS_
|
||||||
- OpenSC_
|
- OpenSC_
|
||||||
@@ -60,7 +60,7 @@ loading the module, you maybe want to check out `this patch
|
|||||||
Hints on OpenSC
|
Hints on OpenSC
|
||||||
---------------
|
---------------
|
||||||
|
|
||||||
Without libnpa ccid-emulator links against libopensc, which is discouraged and hindered since OpenSC
|
Without :ref:`npa` the @PACKAGE_NAME@ links against libopensc, which is discouraged and hindered since OpenSC
|
||||||
version >= 0.12. (We really need to get rid of this dependency or integrate
|
version >= 0.12. (We really need to get rid of this dependency or integrate
|
||||||
better into the OpenSC-framework.) You need the OpenSC components to be
|
better into the OpenSC-framework.) You need the OpenSC components to be
|
||||||
installed (especially :file:`libopensc.so`). Here is an example of how to get the
|
installed (especially :file:`libopensc.so`). Here is an example of how to get the
|
||||||
@@ -76,7 +76,7 @@ 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 ccid-emulator to use it::
|
configure the @PACKAGE_NAME@ to use it::
|
||||||
|
|
||||||
./configure OPENSC_LIBS="-L$PREFIX/lib -lopensc"
|
./configure OPENSC_LIBS="-L$PREFIX/lib -lopensc"
|
||||||
|
|
||||||
@@ -85,14 +85,14 @@ configure ccid-emulator to use it::
|
|||||||
Usage
|
Usage
|
||||||
=====
|
=====
|
||||||
|
|
||||||
ccid-emulator has various command line options to customize the appearance on
|
The @PACKAGE_NAME@ has various command line options to customize the appearance on
|
||||||
the USB host. In order to run ccid-emulator GadgetFS_ must be loaded and
|
the USB host. In order to run the @PACKAGE_NAME@ GadgetFS_ must be loaded and
|
||||||
mounted. ccid-emulator is compatible with the unix driver libccid_ and the
|
mounted. The @PACKAGE_NAME@ 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).
|
||||||
|
|
||||||
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 ccid-emulator or any other "Standardleser" CAT-S or
|
PACE support (such as the @PACKAGE_NAME@ or any other "Standardleser" CAT-S or
|
||||||
"Komfortleser" CAT-C) via PC/SC.
|
"Komfortleser" CAT-C) via PC/SC.
|
||||||
|
|
||||||
|
|
||||||
@@ -13,7 +13,7 @@ do_subst = sed \
|
|||||||
-e 's,[@]OPENSC_LIBS[@],$(OPENSC_LIBS),g' \
|
-e 's,[@]OPENSC_LIBS[@],$(OPENSC_LIBS),g' \
|
||||||
-e 's,[@]top_srcdir[@],$(top_srcdir),g'
|
-e 's,[@]top_srcdir[@],$(top_srcdir),g'
|
||||||
|
|
||||||
EXTRA_DIST = 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
|
||||||
|
|
||||||
.PHONY: doc
|
.PHONY: doc
|
||||||
doc:
|
doc:
|
||||||
@@ -22,3 +22,4 @@ doc:
|
|||||||
touch api.rst
|
touch api.rst
|
||||||
$(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
|
||||||
|
|||||||
@@ -6,9 +6,9 @@
|
|||||||
|
|
||||||
.. _npa:
|
.. _npa:
|
||||||
|
|
||||||
***
|
********************************************************************************
|
||||||
npa
|
@PACKAGE_NAME@
|
||||||
***
|
********************************************************************************
|
||||||
|
|
||||||
:Author:
|
:Author:
|
||||||
Frank Morgner <morgner@informatik.hu-berlin.de>
|
Frank Morgner <morgner@informatik.hu-berlin.de>
|
||||||
@@ -17,11 +17,11 @@ npa
|
|||||||
:Tested Platforms:
|
:Tested Platforms:
|
||||||
Linux (Debian, Ubuntu, OpenMoko)
|
Linux (Debian, Ubuntu, OpenMoko)
|
||||||
|
|
||||||
Welcome to npa. The purpose of npa is to offer an easy to use API for the new
|
Welcome to the @PACKAGE_NAME@. The purpose of the @PACKAGE_NAME@ is to offer an easy to use API for the new
|
||||||
German identity card (neuer Personalausweis, nPA). The library also implements
|
German identity card (neuer Personalausweis, nPA). The library also implements
|
||||||
secure messaging, which could also be used for other cards.
|
secure messaging, which could also be used for other cards.
|
||||||
|
|
||||||
npa is implemented using OpenPACE_.
|
The @PACKAGE_NAME@ is implemented using OpenPACE_.
|
||||||
Some fragments of the source code are based on the source code of the OpenSC tools.
|
Some fragments of the source code are based on the source code of the OpenSC tools.
|
||||||
|
|
||||||
The included npa-tool has support for Password Authenticated Connection
|
The included npa-tool has support for Password Authenticated Connection
|
||||||
@@ -33,7 +33,7 @@ APDUs inside a secure messaging channel established with PACE.
|
|||||||
|
|
||||||
.. include:: autotools.rst
|
.. include:: autotools.rst
|
||||||
|
|
||||||
npa has the following dependencies:
|
The @PACKAGE_NAME@ has the following dependencies:
|
||||||
|
|
||||||
- OpenSC_
|
- OpenSC_
|
||||||
- OpenSSL with OpenPACE_
|
- OpenSSL with OpenPACE_
|
||||||
@@ -57,9 +57,9 @@ an example of how to get the standard installation of OpenSSL with OpenPACE_::
|
|||||||
make
|
make
|
||||||
make install
|
make install
|
||||||
|
|
||||||
Building npa with OpenPACE_ is done best using :command:`pkg-config`. The file
|
Building the @PACKAGE_NAME@ with OpenPACE_ is done best using :command:`pkg-config`. The file
|
||||||
:file:`libcrypto.pc` should be located in ``$INSTALL/lib/pkgconfig``. Here is how
|
:file:`libcrypto.pc` should be located in ``$INSTALL/lib/pkgconfig``. Here is how
|
||||||
to configure npa to use it::
|
to configure the @PACKAGE_NAME@ to use it::
|
||||||
|
|
||||||
./configure PKG_CONFIG_PATH=$PREFIX/lib/pkgconfig
|
./configure PKG_CONFIG_PATH=$PREFIX/lib/pkgconfig
|
||||||
|
|
||||||
@@ -85,7 +85,7 @@ 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 npa to use it::
|
configure the @PACKAGE_NAME@ to use it::
|
||||||
|
|
||||||
./configure OPENSC_LIBS="-L$PREFIX/lib -lopensc"
|
./configure OPENSC_LIBS="-L$PREFIX/lib -lopensc"
|
||||||
|
|
||||||
@@ -111,7 +111,7 @@ Linking against libnpa
|
|||||||
----------------------
|
----------------------
|
||||||
|
|
||||||
Following the section `Installation`_ above, you have installed OpenSC_,
|
Following the section `Installation`_ above, you have installed OpenSC_,
|
||||||
OpenPACE_ and npa to :file:`/tmp/install`. To compile a program using libnpa you
|
OpenPACE_ and the @PACKAGE_NAME@ to :file:`/tmp/install`. To compile a program using libnpa you
|
||||||
need to get the header files from OpenSC_ as well.
|
need to get the header files from OpenSC_ as well.
|
||||||
Here is how
|
Here is how
|
||||||
to compile an external program with these libraries::
|
to compile an external program with these libraries::
|
||||||
@@ -13,9 +13,10 @@ do_subst = sed \
|
|||||||
-e 's,[@]OPENSC_LIBS[@],$(OPENSC_LIBS),g' \
|
-e 's,[@]OPENSC_LIBS[@],$(OPENSC_LIBS),g' \
|
||||||
-e 's,[@]top_srcdir[@],$(top_srcdir),g'
|
-e 's,[@]top_srcdir[@],$(top_srcdir),g'
|
||||||
|
|
||||||
EXTRA_DIST = 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
|
||||||
|
|
||||||
.PHONY: doc
|
.PHONY: doc
|
||||||
doc:
|
doc:
|
||||||
$(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
|
||||||
|
|||||||
@@ -4,9 +4,9 @@
|
|||||||
.. _PCSC-lite: http://pcsclite.alioth.debian.org/
|
.. _PCSC-lite: http://pcsclite.alioth.debian.org/
|
||||||
|
|
||||||
|
|
||||||
**********
|
********************************************************************************
|
||||||
pcsc-relay
|
@PACKAGE_NAME@
|
||||||
**********
|
********************************************************************************
|
||||||
|
|
||||||
:Authors:
|
:Authors:
|
||||||
- Dominik Oepen <oepen@informatik.hu-berlin.de>
|
- Dominik Oepen <oepen@informatik.hu-berlin.de>
|
||||||
@@ -15,7 +15,7 @@ do_subst = sed \
|
|||||||
-e 's,[@]OPENSC_LIBS[@],$(OPENSC_LIBS),g' \
|
-e 's,[@]OPENSC_LIBS[@],$(OPENSC_LIBS),g' \
|
||||||
-e 's,[@]top_srcdir[@],$(top_srcdir),g'
|
-e 's,[@]top_srcdir[@],$(top_srcdir),g'
|
||||||
|
|
||||||
EXTRA_DIST = 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
|
||||||
|
|
||||||
dist_noinst_SCRIPTS = generate_modules.py
|
dist_noinst_SCRIPTS = generate_modules.py
|
||||||
|
|
||||||
@@ -23,4 +23,5 @@ dist_noinst_SCRIPTS = generate_modules.py
|
|||||||
doc:
|
doc:
|
||||||
$(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
|
||||||
./generate_modules.py $(top_srcdir)/src/vpicc --dest-dir=api --suffix=rst --no-toc -1
|
./generate_modules.py $(top_srcdir)/src/vpicc --dest-dir=api --suffix=rst --no-toc -1
|
||||||
|
|||||||
@@ -13,9 +13,9 @@
|
|||||||
.. |vpcd| replace:: :abbr:`vpcd (virtual smart card reader)`
|
.. |vpcd| replace:: :abbr:`vpcd (virtual smart card reader)`
|
||||||
|
|
||||||
|
|
||||||
******************
|
********************************************************************************
|
||||||
Virtual Smart Card
|
@PACKAGE_NAME@
|
||||||
******************
|
********************************************************************************
|
||||||
|
|
||||||
:Authors:
|
:Authors:
|
||||||
- Frank Morgner <morgner@informatik.hu-berlin.de>
|
- Frank Morgner <morgner@informatik.hu-berlin.de>
|
||||||
@@ -26,7 +26,7 @@ Virtual Smart Card
|
|||||||
- Linux (Debian, Ubuntu, OpenMoko)
|
- Linux (Debian, Ubuntu, OpenMoko)
|
||||||
- Windows (only |vpicc|, not |vpcd|)
|
- Windows (only |vpicc|, not |vpcd|)
|
||||||
|
|
||||||
Welcome to virtualsmartcard. The purpose of virtualsmartcard is to emulate a
|
Welcome to the @PACKAGE_NAME@. The purpose of the @PACKAGE_NAME@ is to emulate a
|
||||||
smart card and make it accessible through PCSC. Currently the virtual smart
|
smart card and make it accessible through PCSC. Currently the virtual smart
|
||||||
card supports almost all commands of ISO-7816 including secure messaging.
|
card supports almost all commands of ISO-7816 including secure messaging.
|
||||||
Besides a plain ISO-7816 smart card it is also possible to emulate a German
|
Besides a plain ISO-7816 smart card it is also possible to emulate a German
|
||||||
@@ -55,9 +55,9 @@ The |vpcd| has the following dependencies:
|
|||||||
- PCSC-Lite_
|
- PCSC-Lite_
|
||||||
|
|
||||||
|
|
||||||
========================
|
================================================================================
|
||||||
Running virtualsmartcard
|
Running the @PACKAGE_NAME@
|
||||||
========================
|
================================================================================
|
||||||
|
|
||||||
First you need to make sure that pcscd loads the |vpcd|. You might need to run
|
First you need to make sure that pcscd loads the |vpcd|. You might need to run
|
||||||
:command:`update-reader.conf` to update pcscd's configuration file. Then
|
:command:`update-reader.conf` to update pcscd's configuration file. Then
|
||||||
Reference in New Issue
Block a user