home | help
pkcs11_eventmgr(1)		PAM-pkcs11 tools	      pkcs11_eventmgr(1)

NAME
     pkcs11_eventmgr - SmartCard PKCS#11 Event Manager

SYNTAX
     pkcs11_eventmgr   [[no]debug]   [[no]daemon]  [polling_time=<secs>  ]  [ex-
     pire_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  re-
     moved 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. De-
	    fault: 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_event-
	    mgr.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	    con-
     fig_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 re-
     turns 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		      0.4.4		      pkcs11_eventmgr(1)

home | help