pkcs11_eventmgr(1)

pkcs11_eventmgr1

Smartcard pkcs#11 event manager

Usage

pkcs11_eventmgr [[no] debug] [[no] daemon] [polling_time=<secs>] [expire_time=<secs>] [pkcs11_module=<module>] [config_file=<filename>]

Overview

card_eventmgr is a SmartCard Monitoring that listen to the status of the card reader and dispatch actions on several events. card_eventmgr can be used to several actions, like lock screen on card removal
Three events are supported: card insert, card removal and timeout on removed card. Actions to take are specified in the configuration file

Options

[no]debug

Enable debugging output. Default is no debug

[no]daemon

Runs in background. If debug is unset, detach also from tty. Default: no daemon

polling_time=<secs>

Set polling timeout in secs. Defaults to 1 sec

expire_time=<secs>

Set timeout on card removed. Defaults to 0 (never)

config_file=<configuration file>

Sets de configuration file. Defaults to /etc/pam_pkcs11/card_eventmgr.conf

pkcs11_module=<pkcs11.so library>

Sets the pkcs#11 library module to use. Defaults to /usr/lib/pkcs11/opensc-pkcs11.so

Files

/etc/pam_pkcs11/card_eventmgr.conf

/usr/lib/pkcs11/opensc-pkcs11.so

Examples

To run this program the standard way type:

pkcs11_eventmgr

Alternatively you can specify options:

pkcs11_eventmgr nodebug nodaemon polling_time=5 config_file=${HOME}/.pkcs11_eventmgr.conf

Releases

9 releases since Debian 5.0 (Lenny); the text changed 3 times.

  1. 5.0
  2. 6.0–8
  3. 9–12
  4. 13

Bugs

Some PKCS#11 Libraries fails on card removal and re-insert. to avoid this, pkcs11_eventmgr try to re-initialize stuff by calling C_Finalize() and C_Initialize() on card removal
Some apps like [xscreensaver-command] may fail due to external events ( eg: try to unlock an unlocked session ). In this case, command incorrectly returns error code.
User should take care on this circumstance

Authors

Juan Antonio Martinez <[email protected]>

From libpam-pkcs11 0.6.13-1 in Debian 13 (Trixie). Parsed by carta from the page's man source.