card_eventmgr(1)

1card_eventmgr(1)                  PAM-PKCS#11                 card_eventmgr(1)
2
3
4

NAME

6       card_eventmgr - PCSC-Lite Event Manager
7

SYNTAX

9       card_eventmgr     [debug]    [[no]daemon]    [timeout=<msecs>]    [con‐
10       fig_file=<filename>] [kill] [pidfile=<pidfile>]
11

DESCRIPTION

13       card_eventmgr is a smart card monitoring tool that listen to the status
14       of the card reader and dispatch actions on several events.  card_event‐
15       mgr can be used for several actions: like screen lock on card removal.
16
17       Three events are supported: card insertion, card removal and timeout on
18       removed card. Actions are specified in a configuration file.
19

OPTIONS

21       debug  Enable debugging output.
22
23       [no]daemon
24              Runs  in  background  if  daemon  or  in  foreground if nodaemon
25              (default). If debug is unset, the program dettaches itself  from
26              the tty.
27
28       timeout=<msecs>
29              Set  polling  timeout  in milliseconds. Defaults to 1000 (1 sec‐
30              ond).
31
32       config_file=<configuration file>
33              Sets    de    configuration    file.    Default     value     is
34              /etc/pam_pkcs11/card_eventmgr.conf.
35
36       pidfile=<pidfile>
37              Store the card_eventmgr process ID (pid) in the file pidfile.
38
39       kill   Read  a  process id from pidfile and kill that process. You must
40              use the argument pidfile=<pidfile> to use kill.
41

FILES

43       /etc/pam_pkcs11/card_eventmgr.conf
44

EXAMPLES

46       To run this program the standard way type:
47
48        card_eventmgr
49
50       Alternatively you can specify options:
51
52        card_eventmgr       debug       nodaemon       timeout=500        con‐
53       fig_file=$HOME/.card_eventmgr.conf
54
55       If  you  want  to  start and stop card_eventmgr automatically in an X11
56       session you can create a ~/.xsession file containing:
57        # start the card autolock
58        card_eventmgr pidfile=$HOME/.card_eventmgr.pid
59
60        # start Gnome or something else
61        /usr/bin/x-session-manager
62
63        # kill the card autolock
64        card_eventmgr kill pidfile=$HOME/.card_eventmgr.pid
65

BUGS

67       Some applications like xscreensaver-command may fail  due  to  external
68       events (eg: try to unlock an unlocked session).  In this case, the com‐
69       mand incorrectly returns error code.
70

AUTHORS

72       Juan Antonio Martinez <jonsito@teleline.es>
73       Ludovic Rousseau <ludovic.rousseau@free.fr>
74