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