Manual Reference Pages  - pkcs11_eventmgr (1)

NAME

SmartCard PKCS#11 Event Manager

CONTENTS

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, dettach 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

Alternativly 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 shoult 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 pkcs11_eventmgr (1) 0.4.4
blog comments powered by Disqus