1
ThinkFinger 0.3 Installation Instructions
2
===============================================================================
4
This document describes how compile the ThinkFinger software.
6
Software Required For Compilation
7
=================================
9
The following software must be installed:
11
- the GCC compiler (http://www.gnu.org/software/gcc/)
12
- libtool (http://www.gnu.org/software/libtool/)
13
- pkg-config (http://pkgconfig.freedesktop.org)
14
- the Linux-PAM, development files (http://www.kernel.org/pub/linux/libs/pam/)
15
- libusb, development files, version >= 0.1.12 (http://libusb.sourceforge.net/)
17
To have access to the optional documentation, you also need:
19
- doxygen (http://www.stack.nl/~dimitri/doxygen/)
24
In order to use the the PAM module pam_thinkfinger your Linux kernel has to be
25
compiled with uinput support (CONFIG_INPUT_UINPUT). The location of the uinput
26
interface depends on your distribution. To ensure that your system is properly
27
set up, one of the following interfaces have to exist:
33
If the interface is not there, run:
37
Ask your the maintainers of your distribution to automatically load the module.
42
Once the necessary software is installed, run:
48
You can enable USB debugging support by running 'configure' with the parameter
49
'--enable-usb-debug'. Example:
51
$ ./configure --enable-usb-debug
56
For a proper installation it is very likely that you have to use the parameter
57
'--with-securedir=$PAM_MODULES_DIR' when running 'configure'. $PAM_MODULES_DIR
58
is the directory where the PAM expects the pluggable authentication modules.
59
It is convenient that this directory is '/lib/security'. Example:
61
$ ./configure --with-securedir=/lib/security
63
When building with PAM support you might also want to adjust the parameter
64
'--with-birdir'. The ThinkFinger PAM module uses this directory to look up the
65
biometric identification records (bir files). Example:
67
$ ./configure --with-birdir=/etc/pam_thinkfinger