SYNOPSIS

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

DESCRIPTION

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

       To be able to spy the PC/SC layer, the application flow must be
       modified so that all PC/SC 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 PC/SC wrappers like pyscard (for Python) and
       pcsc-perl (for Perl). The LD_PRELOAD 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

       and run your PC/SC application.

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

        make framework

       Then copy the PCSC.framework directory in /tmp

        cp -a PCSC.framework /tmp

       Copy the official PCSC.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 FIFO 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>



pcsc-lite 1.8.23                  2018-03-22                       PCSC-SPY(1)