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  /etc/reader.conf.d/*  files	 contain configuration information for
       serial and (some) PCMCIA	smart card readers.

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

SYNTAX
       The  /etc/reader.conf.d/* files are 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	 /etc/reader.conf.d/my_reader.conf  file  cor-
       rectly 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				 December 2021			READER.CONF(5)

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

home | help