chipcard-tool(1) [debian man page]

CHIPCARD-TOOL(1)														  CHIPCARD-TOOL(1)

NAME

       chipcard-tool - a commandline client to access smart cards via libchipcard

SYNOPSIS

       chipcard-tool  list|check|atr|monitor  [-CFILE]	[--configfile=FILE]  [-fFILE]  [--file=FILE]  [--logtype=TYPE]	[--loglevel=LEVEL] [--log-
       file=FILE] [-v] [--verbous] [-a] [--showall]  [-tTIMEOUT]  [--timeout=TIMEOUT]  [--readers]  [--drivers]  [--services]  [--start-all]  [-h]
       [--help]

DESCRIPTION

       chipcard-tool is a command line client for libchipcard for testing the setup.

ARGUMENTS

       list   List configured readers.

       check  Check the specified reader.

       atr    Execute ATR on the specified reader.

       monitor
	      Monitor communication between server and clients.

OPTIONS

       -C FILE | --configfile=FILE
	      Configuration file to load.

       -f FILE | --file=FILE
	      This filename is used when reading or writing data such as public keys, bank information etc.

       --logtype=TYPE
	      Set the logtype (console, file).

       --loglevel=LEVEL
	      Set the log level (info, notice, warning, error).

       --logfile=FILE
	      Set the log file (if log type is "file").

       -v | --verbous
	      Every occurrence of this option increases the verbosity.

       -a | --showall
	      Show event log for drivers and readers.

       -t TIMEOUT | --timeout=TIMEOUT
	      Set the total timeout for check command.

       --readers
	      Show readers.

       --drivers
	      Show drivers.

       --services
	      Show services.

       --start-all
	      Start all readers when monitoring server

       -h | --help
	      Shows help.

ENVIRONMENT

FILES

       /etc/chipcard/
	      The system-wide configuration files.

       /var/log/chipcard/
	      The default log files.

SEE ALSO

       http://www.libchipcard.de
	      Homepage of libchipcard project.

       /usr/share/doc/libchipcard-tools/
	      Local documentation

BUGS

REVISION

Manual for chipcard-tool					  2009 March 19th						  CHIPCARD-TOOL(1)

READER.CONF(5)							    PC/SC Lite							    READER.CONF(5)

NAME

       reader.conf - configuration file for pcscd readers' drivers

DESCRIPTION

       The /etc/reader.conf.d/reader.conf file contains configuration information for serial and (some) PCMCIA smart card readers.

       USB readers SHALL NOT be configured using this file.  pcscd uses another mechanism to automatically load USB drivers.

SYNTAX

       The /etc/reader.conf.d/reader.conf is a regular text file. Each reader must be defined by four fields:

	FRIENDLYNAME	 TEXT_STRING
	DEVICENAME	 FILENAME
	LIBPATH 	 FILENAME
	CHANNELID	 NUMBER

       The "FRIENDLYNAME" field is an arbitrary text used to identify the reader. This text is displayed by commands like pcsc_scan(1) that prints
       the names of all the connected and detected readers.

       The "DEVICENAME" field was not used for old drivers (using the IFD handler version 2.0 or earlier). It is now  (IFD  handler  version  3.0)
       used  to  identify the physical port on which the reader is connected. This is the device name of this port. It is dependent of the OS ker-
       nel. The first serial port device is called /dev/ttyS0 under Linux and /dev/cuaa0 under FreeBSD.

       The "LIBPATH" field is the filename of the driver code. The driver is a dynamically loaded piece of code (generally a drivername.so*file).

       The "CHANNELID" is no more used for recent drivers (IFD handler 3.0) and has been superseded by "DEVICENAME". If you  have  an  old  driver
       this  field  is	used  to  indicate  the port to use. You should read your driver documentation to know what information is needed here. It
       should be the serial port number for a serial reader.

EXAMPLE

	# Gemplus GemPCTwin reader with serial communication
	# connected to the first serial port
	FRIENDLYNAME	  "GemPCTwin serial"
	DEVICENAME	  /dev/ttyS0
	LIBPATH 	  /usr/lib64/pcsc/drivers/serial/libccidtwin.so.0.4.1
	CHANNELID	  1

DEBUGGING

       In order to set up your /etc/reader.conf.d/reader.conf file correctly you may want to have debug messages from pcscd.  I recommend  you	to
       start pscsd in the foreground and debug mode using:
	# pcscd --foreground --debug

       If  everything  seems  OK  you can use the pcsc_scan command to print the list of correctly detected readers and try to get the ATR of your
       smart cards.

AUTHOR

       Ludovic Rousseau <ludovic.rousseau@free.fr>

SEE ALSO

       pcscd(8), pcsc_scan(1)

Muscle								    August 2005 						    READER.CONF(5)