pkcs11_eventmgr(1)

1pkcs11_eventmgr(1)             PAM-pkcs11 tools             pkcs11_eventmgr(1)
2
3
4

NAME

6       pkcs11_eventmgr - SmartCard PKCS#11 Event Manager
7

SYNTAX

9       pkcs11_eventmgr   [[no]debug]   [[no]daemon]   [polling_time=<secs>   ]
10       [expire_time=<secs>] [pkcs11_module=<module> ] [config_file=<filename>]
11

DESCRIPTION

13       card_eventmgr is a SmartCard Monitoring that listen to  the  status  of
14       the  card  reader and dispatch actions on several events. card_eventmgr
15       can be used to several actions, like lock screen on card removal
16       Three events are supported: card insert, card removal  and  timeout  on
17       removed card. Actions to take are specified in the configuration file
18

OPTIONS

20       [no]debug
21              Enable debugging output. Default is no debug
22
23       [no]daemon
24              Runs  in  background.  If debug is unset, dettach also from tty.
25              Default: no daemon
26
27       polling_time=<secs>
28              Set polling timeout in secs. Defaults to 1 sec
29
30       expire_time=<secs>
31              Set timeout on card removed. Defaults to 0 (never)
32
33       config_file=<configuration file>
34              Sets      de      configuration      file.      Defaults      to
35              /etc/pam_pkcs11/card_eventmgr.conf
36
37       pkcs11_module=<pkcs11.so library>
38              Sets   the   pkcs#11   library   module   to  use.  Defaults  to
39              /usr/lib/pkcs11/opensc-pkcs11.so
40

FILES

42       /etc/pam_pkcs11/card_eventmgr.conf
43
44       /usr/lib/pkcs11/opensc-pkcs11.so
45

EXAMPLES

47       To run this program the standard way type:
48
49       pkcs11_eventmgr
50
51       Alternativly you can specify options:
52
53       pkcs11_eventmgr     nodebug      nodaemon      polling_time=5      con‐
54       fig_file=${HOME}/.pkcs11_eventmgr.conf
55

BUGS

57       Some  PKCS#11  Libraries fails on card removal and re-insert.  to avoid
58       this, pkcs11_eventmgr try to re-initialize stuff  by  calling  C_Final‐
59       ize() and C_Initialize() on card removal
60       Some apps like [xscreensaver-command] may fail due to external events (
61       eg: try to unlock an unlocked session ).  In this case, command  incor‐
62       rectly returns error code.
63       User shoult take care on this circumstance
64

AUTHORS

66       Juan Antonio Martinez <jonsito@teleline.es>
67