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


 

Index

NAME
SYNTAX
DESCRIPTION
OPTIONS
FILES
EXAMPLES
BUGS
AUTHORS
SEE ALSO