Scroll to navigation

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


card_eventmgr - PCSC-Lite Event Manager


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


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.


Enable debugging output.
Runs in background if daemon or in foreground if nodaemon (default). If debug is unset, the program dettaches itself from the tty.
Set polling timeout in milliseconds. Defaults to 1000 (1 second).
Sets de configuration file. Default value is /etc/pam_pkcs11/card_eventmgr.conf.
Store the card_eventmgr process ID (pid) in the file pidfile.
Read a process id from pidfile and kill that process. You must use the argument pidfile=<pidfile> to use kill.




To run this program the standard way type:


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/

# start Gnome or something else

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


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.


Juan Antonio Martinez <>
Ludovic Rousseau <>


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

Aug 2005 Juan Antonio Martinez