User's Manual

68
To create installation and uninstallation scripts, we strongly urge you not to use functions SkeyForceUnInstallUSB,
SkeyForceUnInstallPar and SkeyForceUnInstallGSS2. These functions were implemented only for solving abnormal
situations, and not for normal use.
We advise you to use the SkeyLogFile function, because, thanks to the log file, one can understand where the
installation script or program is inhibited.
The functions can generate the following error codes:
SKEYINST_OK The operation was correctly terminated.
SKEYINST_ERROR_WAIT The operation was not performed, because, at that time,
the operating system was installing another component.
In this case, the user must be asked to finish all other
current installation processes and then re-try the
operation.
SKEYINST_WARNING_MUST_REBOOT The operation was correctly terminated, but the system
must be rebooted to complete the operation.
SKEYINST_WARNING_MUST_INSERT The operation was correctly terminated, but the USB
device must be fitted to complete the operation.
SKEYINST_ERROR_FAIL The operation failed due to an operating system error.
In this case, more detailed information can be obtained
from the log file.
13.4 Installation of SmartKey in Linux
On Linux there are three package for the installation and the use of the SmartKey:
• user level usb – package smartkey-linux-user-usb.tar.gz
• user level lpt – package smartkey-linux-user-lpt.tar.gz
•
kernel level – package smartkey-linux-2.4.tar.gz and smartkey-linux-2.6.tar.gz
The user level packages are kernel and distribution independent instead the kernel level package is kernel and
distribution dependent therefore is preferable to use the user level package if possible.
13.4.1 Linux user level usb
The user level package doesn’t require the installation of the driver but it’s available an object file to statically compile
with the application to communicate with the SmartKey device. This package only supports the SmartKey 3 USB and
the SmartKey DL dongle.
13.4.2 Linux user level lpt
The user level package doesn’t require the installation of the driver but it’s available an object file to statically compile
with the application to communicate with the SmartKey device. This package only supports the SmartKey Parallel
device.
13.4.3 Linux kernel level
The kernel level package includes the SmartKey kernel driver for a list of the precompiled kernel and distribution Linux
environment. This package only supports the SmartKey Parallel, the SmartKey 2 USB and the SmartKey 3 USB device.
The installation of drives in Linux calls for the following requirements:
•
must have root privileges
• must know the kernel version used and the version of the GCC compiler used for compiling the kernel. These
pieces of information can be obtained with command cat /proc/version.
These are the installation operations:
• In CD-ROM directory Sdk\Manual_Protection\Others search for the file containing the module for
the kernel installed and compiled with the same compiler used for the kernel (in the packages smartkey-
linux-2.4.tar.gz and smartkey-linux-2.6.tar.gz). If the list does not contain the file for the
versions you use, you can request it from Eutronsec' service department
• unzip the selected file