Man page - card_eventmgr(1)

Packages contains this manual

Package: libpam-pkcs11
apt-get install libpam-pkcs11

Manuals in package:

Documentations in package:

libpam-pkcs11

Manual

card_eventmgr

NAME
SYNTAX
DESCRIPTION
OPTIONS
FILES
EXAMPLES
BUGS
AUTHORS
SEE ALSO

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 detaches 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>