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

updated links and info for installation

Browse Source 
git-svn-id: https://vsmartcard.svn.sourceforge.net/svnroot/vsmartcard@731 96b47cad-a561-4643-ad3b-153ac7d7599c
This commit is contained in:
frankmorgner
2012-04-05 21:55:34 +00:00
parent e2db08cc15
commit 4c2849c4f4
2 changed files with 44 additions and 42 deletions
Download Patch File Download Diff File Expand all files Collapse all files

43
npa/doc/README.rst
View File

@@ -1,7 +1,7 @@
.. highlight:: sh .. highlight:: sh
.. _OpenSC: http://www.opensc-project.org/opensc .. _OpenSC with PACE: http://github.com/frankmorgner/OpenSC
.. _OpenPACE: http://sourceforge.net/projects/openpace/ .. _OpenPACE: http://openpace.sourceforge.net
.. _npa: .. _npa:
@@ -15,10 +15,10 @@ nPA Smart Card Library
:License: :License:
GPL version 3 GPL version 3
:Tested Platforms: :Tested Platforms:
Linux (Debian, Ubuntu, OpenMoko) - Linux (Debian, Ubuntu, OpenMoko)
:Potential Platforms:
- Windows - Windows
- Unix-like operating systems (Mac OS, Solaris, BSD, ...) :Potential Platforms:
Unix-like operating systems (Mac OS, Solaris, BSD, ...)
Welcome to the nPA Smart Card Library. The purpose of the nPA Smart Card Library is to offer an easy to use API for the new Welcome to the nPA Smart Card Library. The purpose of the nPA Smart Card Library 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
@@ -38,7 +38,7 @@ APDUs inside a secure messaging channel established with PACE.
The nPA Smart Card Library has the following dependencies: The nPA Smart Card Library has the following dependencies:
- OpenSC_ - `OpenSC with PACE`_
- OpenSSL with OpenPACE_ - OpenSSL with OpenPACE_
@@ -46,8 +46,9 @@ The nPA Smart Card Library has the following dependencies:
Hints on OpenSSL with OpenPACE Hints on OpenSSL with OpenPACE
------------------------------ ------------------------------
libnpa links against libcrypto, which must be patched with OpenPACE_. Here is The nPA Smart Card Library links against OpenSSL, which must be patched with OpenPACE_.
an example of how to get the standard installation of OpenSSL with OpenPACE_:: Here is an example of how to get the standard installation of OpenSSL with
OpenPACE_::
PREFIX=/tmp/install PREFIX=/tmp/install
OPENPACE=openpace OPENPACE=openpace
@@ -71,15 +72,15 @@ to configure the nPA Smart Card Library to use it::
Hints on OpenSC Hints on OpenSC
--------------- ---------------
libnpa links against libopensc, which is discouraged and hindered since OpenSC The nPA Smart Card Library links against OpenSC, which is discouraged and hindered
version >= 0.12. (We really need to get rid of this dependency or integrate since OpenSC version >= 0.12. However, I extended OpenSC to support smart card
better into the OpenSC-framework.) You need the OpenSC components to be readers with PACE capabilities. You need the OpenSC components to be installed
installed (especially :file:`libopensc.so`). Here is an example of how to get the (especially :file:`libopensc.so`). Here is an example of how to get the
standard installation of OpenSC_:: standard installation of `OpenSC with PACE`_::
PREFIX=/tmp/install PREFIX=/tmp/install
OPENSC=opensc OPENSC=opensc
svn co http://www.opensc-project.org/svn/opensc/trunk $OPENSC git clone git://github.com/frankmorgner/OpenSC.git $OPENSC
cd $OPENSC cd $OPENSC
autoreconf -i autoreconf -i
# adding PKG_CONFIG_PATH here lets OpenSC use OpenSSL with OpenPACE # adding PKG_CONFIG_PATH here lets OpenSC use OpenSSL with OpenPACE
@@ -115,15 +116,15 @@ npa-tool will show a password prompt.
Linking against libnpa Linking against libnpa
---------------------- ----------------------
Following the section `Installation`_ above, you have installed OpenSC_, Following the section `Installation`_ above, you have installed `OpenSC with
OpenPACE_ and the nPA Smart Card Library to :file:`/tmp/install`. To compile a program using libnpa you PACE`_, OpenPACE_ and the nPA Smart Card Library to :file:`/tmp/install`. To compile a
need to get the header files from OpenSC_ as well. program using nPA Smart Card Library you need to get the header files from `OpenSC with
Here is how PACE`_ as well. Here is how to compile an external program with these
to compile an external program with these libraries:: libraries::
PREFIX=/tmp/install PREFIX=/tmp/install
OPENSC=opensc OPENSC=opensc
svn co http://www.opensc-project.org/svn/opensc/trunk $OPENSC git clone git://github.com/frankmorgner/OpenSC.git $OPENSC
cc example.c -I$OPENSC/src \ cc example.c -I$OPENSC/src \
$(env PKG_CONFIG_PATH=$PREFIX/lib/pkgconfig \ $(env PKG_CONFIG_PATH=$PREFIX/lib/pkgconfig \
pkg-config --cflags --libs npa) pkg-config --cflags --libs npa)
@@ -132,7 +133,7 @@ Alternatively you can specify libraries and flags by hand::
PREFIX=/tmp/install PREFIX=/tmp/install
OPENSC=opensc OPENSC=opensc
svn co http://www.opensc-project.org/svn/opensc/trunk $OPENSC git clone git://github.com/frankmorgner/OpenSC.git $OPENSC
cc example.c -I$OPENSC/src \ cc example.c -I$OPENSC/src \
-I$PREFIX/include \ -I$PREFIX/include \
-L$PREFIX/lib -lcrypto -lnpa -lopensc" -L$PREFIX/lib -lcrypto -lnpa -lopensc"

43
npa/doc/README.rst.in
View File

@@ -1,7 +1,7 @@
.. highlight:: sh .. highlight:: sh
.. _OpenSC: http://www.opensc-project.org/opensc .. _OpenSC with PACE: http://github.com/frankmorgner/OpenSC
.. _OpenPACE: http://sourceforge.net/projects/openpace/ .. _OpenPACE: http://openpace.sourceforge.net
.. _npa: .. _npa:
@@ -15,10 +15,10 @@
:License: :License:
GPL version 3 GPL version 3
:Tested Platforms: :Tested Platforms:
Linux (Debian, Ubuntu, OpenMoko)
:Potential Platforms:
- Windows - 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 the @PACKAGE_NAME@. The purpose of the @PACKAGE_NAME@ 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
@@ -38,7 +38,7 @@ APDUs inside a secure messaging channel established with PACE.
The @PACKAGE_NAME@ has the following dependencies: The @PACKAGE_NAME@ has the following dependencies:
- OpenSC_ - `OpenSC with PACE`_
- OpenSSL with OpenPACE_ - OpenSSL with OpenPACE_
@@ -46,8 +46,9 @@ The @PACKAGE_NAME@ has the following dependencies:
Hints on OpenSSL with OpenPACE Hints on OpenSSL with OpenPACE
------------------------------ ------------------------------
libnpa links against libcrypto, which must be patched with OpenPACE_. Here is The @PACKAGE_NAME@ links against OpenSSL, which must be patched with OpenPACE_.
an example of how to get the standard installation of OpenSSL with OpenPACE_:: Here is an example of how to get the standard installation of OpenSSL with
OpenPACE_::
PREFIX=/tmp/install PREFIX=/tmp/install
OPENPACE=openpace OPENPACE=openpace
@@ -71,15 +72,15 @@ to configure the @PACKAGE_NAME@ to use it::
Hints on OpenSC Hints on OpenSC
--------------- ---------------
libnpa links against libopensc, which is discouraged and hindered since OpenSC The @PACKAGE_NAME@ links against OpenSC, which is discouraged and hindered
version >= 0.12. (We really need to get rid of this dependency or integrate since OpenSC version >= 0.12. However, I extended OpenSC to support smart card
better into the OpenSC-framework.) You need the OpenSC components to be readers with PACE capabilities. You need the OpenSC components to be installed
installed (especially :file:`libopensc.so`). Here is an example of how to get the (especially :file:`libopensc.so`). Here is an example of how to get the
standard installation of OpenSC_:: standard installation of `OpenSC with PACE`_::
PREFIX=/tmp/install PREFIX=/tmp/install
OPENSC=opensc OPENSC=opensc
svn co http://www.opensc-project.org/svn/opensc/trunk $OPENSC git clone git://github.com/frankmorgner/OpenSC.git $OPENSC
cd $OPENSC cd $OPENSC
autoreconf -i autoreconf -i
# adding PKG_CONFIG_PATH here lets OpenSC use OpenSSL with OpenPACE # adding PKG_CONFIG_PATH here lets OpenSC use OpenSSL with OpenPACE
@@ -115,15 +116,15 @@ npa-tool will show a password prompt.
Linking against libnpa Linking against libnpa
---------------------- ----------------------
Following the section `Installation`_ above, you have installed OpenSC_, Following the section `Installation`_ above, you have installed `OpenSC with
OpenPACE_ and the @PACKAGE_NAME@ to :file:`/tmp/install`. To compile a program using libnpa you PACE`_, OpenPACE_ and the @PACKAGE_NAME@ to :file:`/tmp/install`. To compile a
need to get the header files from OpenSC_ as well. program using @PACKAGE_NAME@ you need to get the header files from `OpenSC with
Here is how PACE`_ as well. Here is how to compile an external program with these
to compile an external program with these libraries:: libraries::
PREFIX=/tmp/install PREFIX=/tmp/install
OPENSC=opensc OPENSC=opensc
svn co http://www.opensc-project.org/svn/opensc/trunk $OPENSC git clone git://github.com/frankmorgner/OpenSC.git $OPENSC
cc example.c -I$OPENSC/src \ cc example.c -I$OPENSC/src \
$(env PKG_CONFIG_PATH=$PREFIX/lib/pkgconfig \ $(env PKG_CONFIG_PATH=$PREFIX/lib/pkgconfig \
pkg-config --cflags --libs npa) pkg-config --cflags --libs npa)
@@ -132,7 +133,7 @@ Alternatively you can specify libraries and flags by hand::
PREFIX=/tmp/install PREFIX=/tmp/install
OPENSC=opensc OPENSC=opensc
svn co http://www.opensc-project.org/svn/opensc/trunk $OPENSC git clone git://github.com/frankmorgner/OpenSC.git $OPENSC
cc example.c -I$OPENSC/src \ cc example.c -I$OPENSC/src \
-I$PREFIX/include \ -I$PREFIX/include \
-L$PREFIX/lib -lcrypto -lnpa -lopensc" -L$PREFIX/lib -lcrypto -lnpa -lopensc"