card_eventmgr - Lite Event Manager
Please see following description for synopsis
card_eventmgr(1) PAM-PKCS#11 card_eventmgr(1)
NAME
card_eventmgr - PCSC-Lite Event Manager
SYNTAX
/usr/lib/pam_pkcs11/card_eventmgr [debug] [[no]daemon] [time-
out=<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_event-
mgr 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 sec-
ond).
config_file=<configuration file>
Sets de configuration file. Default value is /etc/secu-
rity/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/security/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 con-
fig_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 com-
mand incorrectly returns error code.
AUTHORS
Juan Antonio Martinez <jonsito@teleline.es>
Ludovic Rousseau <ludovic.rousseau@free.fr>
SEE ALSO
pam_pkcs11(8), README.eventmgr, PAM-PKCS11 User Manual
Juan Antonio Martinez Aug 2005 card_eventmgr(1)