Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
READER.CONF(5)			  PC/SC	Lite			READER.CONF(5)

NAME
       reader.conf - configuration file	for pcscd readers' drivers

DESCRIPTION
       The  /usr/local/etc/reader.conf.d/reader.conf  file contains configura-
       tion information	for serial and (some) PCMCIA smart card	readers.

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

SYNTAX
       The  /usr/local/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 han-
       dler  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 kernel. 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/local/lib/pcsc/drivers//serial/libc-
       cidtwin.so.0.4.1
	CHANNELID	  1

DEBUGGING
       In  order  to set up your /usr/local/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)

NAME | DESCRIPTION | SYNTAX | EXAMPLE | DEBUGGING | AUTHOR | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=reader.conf&sektion=5&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help