Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Thursday, June 13, 2019
 
 

card_eventmgr (1)

Name

card_eventmgr - Lite Event Manager

Synopsis

Please see following description for synopsis

Description

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)