pkcs11_eventmgr(1) [debian man page]

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> ] [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_Final-
       ize() 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						       0.4.4							pkcs11_eventmgr(1)

card_eventmgr(1)						    PAM-PKCS#11 						  card_eventmgr(1)

NAME

       card_eventmgr - PCSC-Lite Event Manager

SYNTAX

       card_eventmgr [debug] [[no]daemon] [timeout=<msecs>] [config_file=<filename>] [kill] [pidfile=<pidfile>]

DESCRIPTION

       card_eventmgr  is  a  smart  card  monitoring  tool  that  listen  to the status of the card reader and dispatch actions on several events.
       card_eventmgr can be used for several actions: like screen lock on card removal.

       Three events are supported: card insertion, card removal and timeout on removed card. Actions are specified in a configuration file.

OPTIONS

       debug  Enable debugging output.

       [no]daemon
	      Runs in background if daemon or in foreground if nodaemon (default). If debug is unset, the program dettaches itself from the tty.

       timeout=<msecs>
	      Set polling timeout in milliseconds. Defaults to 1000 (1 second).

       config_file=<configuration file>
	      Sets de configuration file. Default value is /etc/pam_pkcs11/card_eventmgr.conf.

       pidfile=<pidfile>
	      Store the card_eventmgr process ID (pid) in the file pidfile.

       kill   Read a process id from pidfile and kill that process. You must use the argument pidfile=<pidfile> to use kill.

FILES

       /etc/pam_pkcs11/card_eventmgr.conf

EXAMPLES

       To run this program the standard way type:

	card_eventmgr

       Alternatively you can specify options:

	card_eventmgr debug nodaemon timeout=500 config_file=$HOME/.card_eventmgr.conf

       If you want to start and stop card_eventmgr automatically in an X11 session you can create a ~/.xsession file containing:
	# start the card autolock
	card_eventmgr pidfile=$HOME/.card_eventmgr.pid

	# start Gnome or something else
	/usr/bin/x-session-manager

	# kill the card autolock
	card_eventmgr kill pidfile=$HOME/.card_eventmgr.pid

BUGS

       Some applications like xscreensaver-command may fail due to external events (eg: try to unlock an unlocked session).   In  this	case,  the
       command incorrectly returns error code.

AUTHORS

       Juan Antonio Martinez <jonsito@teleline.es>
       Ludovic Rousseau <ludovic.rousseau@free.fr>

SEE ALSO

       pam_pkcs11(8), pkcs11_eventmgr(1), README.eventmgr, PAM-PKCS11 User Manual

Juan Antonio Martinez						     Aug 2005							  card_eventmgr(1)