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

# card\_eventmgr(1)

PCSC-Lite Event Manager

## 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\>

## SEE ALSO

[**pam\_pkcs11**(8)](/pam_pkcs11/8.md), [**pkcs11\_eventmgr**(1)](/pkcs11_eventmgr/1.md), README.eventmgr, PAM-PKCS11 User Manual