pkcs11_eventmgr(1)

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

NAME

6       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       ]
12

DESCRIPTION

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

OPTIONS

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

FILES

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

EXAMPLES

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

BUGS

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

AUTHORS

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