librdrselect.so.1 is a PC/SC lite interposer that that filters
reader lists passed from libpcsclite.so.1 to a client, when 
the client calls the PC/SC-lite API SCardListReaders() function.

Specifically, the librdrselect.so.1 interposer library intercepts 
the SCardListReaders() call and filters the readers returned by 
libpcsclite.so.1 based on user specified criteria.

The input args to librdrselect.so.1 are passed via the
environment variable LIBRDRSELECT.

LIBRDRSELECT = [-v] {-n <rdr#> | -r <regex> }
         -n <rdrnbr>     Zero based index of single reader to select
         -r <regex>      Regular expression to match on
         -v              verbose (logs info to stdout) 

For example:

	$ LIBRDRSELECT="-r .*ABC.*"
	$ export LIBRDRSELECT
	$ LD_PRELOAD=./librdrselect.so.1 ./myApp


IMPORTANT:  When using Sun Ray Connector:

           For normal applications LD_PRELOAD is used, but for
           Sun Ray Windows Connector, a different hook must
           be used because of security restrictions with the 
           setgid bit.   For Sun Ray Connector, instead of
           setting LD_PRELOAD as shown above, specify
           SUN_LIB_PCSCLITE instead.
   

The above example will run myApp and match (ie. let pass to the
client application) any and all reader names that have the text
"ABC" in them (without quotation marks).

In the same directory there is an executable named 'lister'.
The source code for that is the included lister.c 
The lister program can be run in two modes, in one mode
it lists all the readers retured by SCardListReaders()
without doing any filtering.  In another mode, it enables
librdrselect.so.1 interposing and filters according the the 
regexp passed by the user on the command line (without quote
markes or enclosing slash characters).

If testlib is invoked without any arguments, it simply
returns all readers without filtering.

If testlib is invoked with an argument on the command line,
testlib will run lister with librdrselect.so.1 interposed, 
and pass to it the regular expression on the command line,

