card_eventmgr(1) [debian man page]

card_eventmgr(1)						    PAM-PKCS#11 						  card_eventmgr(1)

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 dettaches 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), pkcs11_eventmgr(1), README.eventmgr, PAM-PKCS11 User Manual

Juan Antonio Martinez						     Aug 2005							  card_eventmgr(1)

PCSCD(8)							    PC/SC Lite								  PCSCD(8)

NAME

       pcscd - PC/SC Smart Card Daemon

SYNOPSIS

       pcscd [options]

OPTIONS

       -a, --apdu
	      log APDUs and SW using the debug method (see --debug).

       -c, --config file
	      Specifies the file file as an alternate location for /etc/reader.conf.d/reader.conf.

       -f, --foreground
	      Runs pcscd in the foreground and sends log messages to stderr instead of syslog(3).

       -d, --debug
	      use the lowest log level. Any log message of this level or above will be sent to stderr or syslog(3) depending on the use of --fore-
	      ground.

       --info use info log level. This is the default log level.

       --error
	      use error log level.

       --critical
	      use critical log level.

       The log levels are ordered as: debug < info < error < critical. Use a log level l will log this level and all the levels above it.

       -h, --help
	      Displays information about the pcscd command line

       -v, --version
	      Displays the program version number

       -H, --hotplug
	      Ask pcscd to rescan the USB buses for added or removed readers and re-read the /etc/reader.conf.d/reader.conf file to  detect  added
	      or removed non-USB readers (serial or PCMCIA).

DESCRIPTION

       pcscd is the daemon program for pcsc-lite. It is a resource manager that coordinates communications with smart card readers and smart cards
       and cryptographic tokens that are connected to the system.

       It allows applications to access smart cards and readers using the winscard API but without knowing details of the card or reader.

       pcscd coordinates the loading of drivers for card readers.

SERIAL SMART CARD READER DRIVERS

       Smart card reader drivers are placed in the /usr/lib64/pcsc/drivers directory. Each driver is simply an .so file.  pcscd locates the driver
       using  the  /etc/reader.conf.d/reader.conf  file.   See	the  reader.conf(5)  manual  page  for more information.  Drivers are available at
       http://www.musclecard.com/drivers.html.

USB SMART CARD READER DRIVERS

       USB smart card reader drivers are located  in  /usr/lib64/pcsc/drivers  directory  as  a  bundle.  You  shall  not  add	a  USB	driver	in
       /etc/reader.conf.d/reader.conf file.

FILES

       /etc/reader.conf.d/reader.conf : Reader configuration file

       /var/run/pcscd/pcscd.pid : process id of the running pcscd

       /usr/lib64/pcsc/drivers : directory containing bundles for USB drivers

SEE ALSO

       bundleTool(8), reader.conf(5), syslog(3)

AUTHORS

       David Corcoran <corcoran@musclecard.com> and Ludovic Rousseau <ludovic.rousseau@free.fr>

Muscle								   January 2007 							  PCSCD(8)