NAME

       pkcs11_eventmgr - SmartCard PKCS#11 Event Manager

SYNTAX

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

DESCRIPTION

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

OPTIONS

       [no]debug
              Enable debugging output. Default is no debug

       [no]daemon
              Runs in background. If debug is unset, detach also from tty. Default: no daemon

       polling_time=<secs>
              Set polling timeout in secs. Defaults to 1 sec

       expire_time=<secs>
              Set timeout on card removed. Defaults to 0 (never)

       config_file=<configuration file>
              Sets de configuration file. Defaults to /etc/pam_pkcs11/card_eventmgr.conf

       pkcs11_module=<pkcs11.so library>
              Sets the pkcs#11 library module to use. Defaults to /usr/lib/pkcs11/opensc-pkcs11.so

FILES

       /etc/pam_pkcs11/card_eventmgr.conf

       /usr/lib/pkcs11/opensc-pkcs11.so

EXAMPLES

       To run this program the standard way type:

       pkcs11_eventmgr

       Alternatively you can specify options:

       pkcs11_eventmgr nodebug nodaemon polling_time=5 config_file=${HOME}/.pkcs11_eventmgr.conf

BUGS

       Some  PKCS#11  Libraries  fails  on  card  removal  and re-insert.  to avoid this, pkcs11_eventmgr try to
       re-initialize stuff by calling C_Finalize() and C_Initialize() on card removal
       Some apps like [xscreensaver-command] may fail due to external events ( eg: try  to  unlock  an  unlocked
       session ).  In this case, command incorrectly returns error code.
       User should take care on this circumstance

AUTHORS

       Juan Antonio Martinez <jonsito@teleline.es>

SEE ALSO

       pam_pkcs11(8), card_eventmgr(5)
       README.eventmgr
       PAM-PKCS11 User Manual

Juan Antonio Martinez                                 0.4.4                                   pkcs11_eventmgr(1)