Readme

Currently CardOS API is only available for a limited subset of Linux distributions.
  1. Select the CardOS API package that suits your installation best.
  2. Extract the archive as user root to the root directory of your Linux installation.
  3. Make sure that the library installation directory (default is /usr/local/lib) is listed in /etc/ld.so.conf. Either restart your system or run ldconfig to update the cache of the Linux runtime linker.

Example:

user@system > su -
Enter password:
root@system # cd /
root@system # tar -xzvf <path_to_package>CardOS_API_<version>.tar.gz
root@system # ldconfig
root@system # exit

This will install the following files on your system:

Path File Version Description
/usr/local/bin siecapin N/a CardOS API PIN Management Utility
(Documentation)
/usr/local/lib libsiecacrd.so N/a CardOS API Card Interface Library
libsiecadlg.so N/a CardOS API GUI Library
libsiecap11.so N/a CardOS API PKCS#11 Library
libsiecap15.so N/a CardOS API PKCS#15 Library
libgmp.3.4.2.so 4.2.2 GNU Multiple Precision Arithmetic Library. Starting with CardOS API V3.2.
libces.1.1.5.so 2.5.1 Software implementation of cryptographic algorithms. Starting with CardOS API V3.2.
/etc sieca.conf N/a CardOS API configuration file.
(see Configuration on Linux)
/usr/local/sieca/doc/Images *.gif N/a Images and icons.
/usr/local/sieca/doc/Linux ReadMe.Linux.html N/a CardOS API for Linux Readme
/usr/local/sieca/doc/Linux/doc PKCS11PinUtilityLinux.html N/a CardOS API PIN Management Utility documentation.
/usr/local/sieca/doc/Linux/doc/screens *.gif N/a CardOS API PIN Management Utility documentation screen shots.
/usr/local/sieca/scripts InitToken????.cpd N/a Initialization script for CardOS smart cards. ???? identifies the type of the CardOS smart card. The availability of CardOS API initialisation scripts for the individual CardOS smart card types depends on the CardOS API version.

C802 = CardOS/M4.00
C803 = CardOS/M4.01
C804 = CardOS/M4.01a
C806 = CardOS V4.2
C807 = CardOS V4.3
C808 = CardOS V4.3B
C80A = CardOS V4.2 DI
C80B = CardOS V4.2C

Note: Depending on the CardOS API version an additional InitTokenC806.rsa2048.cpd script including the RSA 2048bit package for CardOS V4.2 cards might be available. Rename InitTokenC806.rsa2048.cpd to InitTokenC806.cpd and InitTokenC806.rsa2048.sig to InitTokenC806.sig to include the RSA 2048bit package in the default token initialization sequence run by calling C_InitToken().

InitToken????.sig N/a Signature file for the respective InitToken????.cpd file.

In case you want to install to a different location you may extract the archive to a temporary folder and copy the libraries to a different location.

Please note that the documentation files (/usr/local/sieca/doc) might not be installed on all platforms. If this is the case please refer to the documentation files contained on your installation media.