home | help 
card_eventmgr(1)		   PAM-PKCS#11			card_eventmgr(1)

NAME
     card_eventmgr - PCSC-Lite Event Manager

SYNTAX
     card_eventmgr  [debug]  [[no]daemon]  [timeout=<msecs>] [config_file=<file-
     name>] [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 re-
     moved 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_event-
     mgr.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 incor-
     rectly 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

Juan Antonio Martinez		    Aug 2005			card_eventmgr(1)
home | help