card_eventmgr
Section: PAM-PKCS#11 (1)
Updated: Aug 2005
Page Index
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