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)