pcsc-spy (1)

Leading comments

Automatically generated by Pod::Man 4.09 (Pod::Simple 3.35)

Standard preamble:
========================================================================

(The comments found at the beginning of the groff file "man1/pcsc-spy.1".)

NAME

pcsc-spy - A PC/SC spy command

SYNOPSIS

pcsc-spy [-n|--nocolor] [-d|--diffable] [-h|--help] [fifo_filename]

DESCRIPTION

pcsc-spy displays calls of an application. It must be used with the libpcscspy.so library.

To be able to spy the

layer, the application flow must be modified so that all calls are redirected. Two options are available:

- the application is linked with libpcsclite.so.1

- the application loads the libpcsclite.so.1 library using dlopen(3)

OPTIONS

-d, --diffable

Remove the variable parts (like handler values) from the output so that two execution can be more easily compared.

-h, --help

Display a short help text.

-n, --nocolor

Disable the output colorization (if you want redirect the output in a file for example).

-v, --version

Print the version of the pcsc-spy program plus a copyright, a list of authors.

EXAMPLES

Applications linked with libpcsclite.so.1

We will use the standard "LD_PRELOAD" loader option to load our spying library.

Example:

 LD_PRELOAD=/usr/lib/libpcscspy.so pcsc_scan

Application loading libpcsclite.so.1

This is the case for the wrappers like pyscard (for Python) and pcsc-perl (for Perl). The mechanism can't be used. Instead we replace the libpcsclite.so.1 library by the spying one.

You may use install_spy.sh and uninstall_spy.sh to install and uninstall the spying library.

Using the spying library without pcsc-spy is not a problem but has side effects:

- a line ``libpcsclite_nospy.so.1: cannot open shared object file: No such file or directory'' will be displayed

- some

time will be lost because of the calls redirection

Starting the spy tool

 pcsc-spy

If a command argument is passed we use it instead of the default ~/pcsc-spy

file. It is then possible to record an execution log and use pcsc-spy multiple times on the same log.

To create the log file just do:

 mkfifo ~/pcsc-spy
 cat ~/pcsc-spy > logfile

and run your

application.

Mac

OS X

The installation is not automatic. In the pcsc-lite/src/spy directory do:

 make framework

Then copy the

.framework directory in /tmp

 cp -a PCSC.framework /tmp

Copy the official

.framework (binary only) in /tmp

 cp /System/Library/Frameworks/PCSC.framework/PCSC /tmp

Run the application to debug as:

 DYLD_FRAMEWORK_PATH=/tmp pcsctest

FILES

~/pcsc-spy file is used by libpcsclite.so.1 to send the raw log lines

SEE ALSO

pcscd(8)

AUTHOR

This manual page was written by Ludovic Rousseau <rousseau@free.fr>