---
name: "pkcs11_eventmgr"
section: "1"
platform: "linux"
package: "libpam-pkcs11"
version: "0.6.13-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/pkcs11_eventmgr"
---

# pkcs11\_eventmgr(1)

SmartCard PKCS#11 Event Manager

## NAME

pkcs11\_eventmgr - SmartCard PKCS#11 Event Manager

## SYNTAX

pkcs11\_eventmgr \[*\[no\]debug*\] \[*\[no\]daemon*\] \[*polling\_time=\<secs\>* \] \[*expire\_time=\<secs\>*\] \[*pkcs11\_module=\<module\>* \] \[*config\_file=\<filename\>*\]

## DESCRIPTION

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

## 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 \<jonsito@teleline.es\>

## SEE ALSO

[pam\_pkcs11(8)](/pam_pkcs11/8.md), card\_eventmgr(5)\
 README.eventmgr\
 PAM-PKCS11 User Manual