Evolution of Apple pcsc-lite (from Jaguar to Mavericks)

When Apple first introduced the smart card support in Mac OS X 10.2 Jaguar (August 2002) pcsc-lite was at version 1.0.x and I just started to add my patches to it. At that time the author and maintainer of pcsc-lite was David Corcoran.

In this article we will do some archaeology work. Apple moved the SmartCardServices to the SmartCard Services public project in January 2009 at the time of Leopard 10.5. The first tag on source code available in the subversion repository is for OSX-10.5.6. The detailed history of the source code before that version is not publicly available and must be reverse engineered "by hand".

On the "official" pcsc-lite side, the oldest tagged version is 1.1.2-beta1 from September 2002.

Terminology

The pcsc-lite provided by Apple is called, in this article, Apple pcsc-lite.

The original pcsc-lite and ancestor of Apple pcsc-lite is called "official" pcsc-lite. The "official" pcsc-lite is used mainly on GNU/Linux (and GNU/Linux distributions) and is also used on FreeBSD, NetBSD, OpenBSD, Android, and maybe other Unix-like systems I don't know about.

Oracle (ex-Sun) has its own forked version of pcsc-lite for Solaris. An old version of this source code is available in the Solaris branch.

10.2 Jaguar

August 2002

SmartCardServices-10

The PCSCLITE_VERSION_NUMBER in src/pcsclite.h is "1.1.1". The same 1.1.1 version of the "official" pcsc-lite was released 5 Jun, 2002. I wrote above I do not have the version 1.1.1 in the subversion history. So we will use version 1.1.2-beta1 instead.

A diffstat between the two versions gives us:
 debuglog.c         |   76 +++++++++++++++++++++++++++++++++++++-----
 eventhandler.c     |    1
 ifdwrapper.c       |    8 ++++
 pcscdaemon.c       |   94 +++++++++++++++++++++++++++++++++++++++++++----------
 powermgt_generic.h |    2 -
 readerfactory.c    |    4 +-
 sys_unix.c         |    2 -
 winscard_clnt.c    |    2 -
 winscard_msg.c     |    2 -
 9 files changed, 157 insertions(+), 34 deletions(-)

New code in "official" pcsc-lite (and then not present in Apple pcsc-lite):
  • Win32 support in log functions
  • APDU log
  • store pcscd pid in a file to detect another running pcscd
No code added in Apple version of pcsc-lite.
    So it looks like that Apple just used version 1.1.1 of pcsc-lite without changes at this first step.

    10.3 Panther

    October 2003

    SmartCardServices-15

    Diffstat against the previous version:
    $ diff -ru SmartCardServices-10/src/ SmartCardServices-15/src/PCSC/ | diffstat
    atrhandler.c | 18
    atrhandler.h | 17
    configfile.c | 17
    configfile.h | 17
    debuglog.c | 93 +++-
    debuglog.h | 49 +-
    dyn_generic.h | 17
    dyn_macosx.c | 17
    eventhandler.c | 23 +
    eventhandler.h | 17
    hotplug.h | 28 +
    hotplug_macosx.c | 1211 +++++++++++++++++++++++++++--------------------------
    ifdhandler.h | 17
    ifdwrapper.c | 17
    ifdwrapper.h | 17
    mscdefines.h | 30 -
    musclecard.c | 28 +
    musclecard.h | 30 -
    muscletest.c | 19
    pcscdaemon.c | 117 ++++-
    pcsclite.h | 32 -
    powermgt_generic.h | 19
    powermgt_macosx.c | 40 +
    prothandler.c | 19
    prothandler.h | 17
    readerfactory.c | 28 +
    readerfactory.h | 17
    sys_generic.h | 19
    sys_unix.c | 19
    testpcsc.c | 17
    thread_generic.h | 17
    thread_macosx.c | 17
    tokenfactory.c | 37 +
    tokenfactory.h | 29 +
    tokenparser.c | 17
    utils/bundleTool.c | 62 +-
    winscard.c | 25 +
    winscard.h | 30 -
    winscard_clnt.c | 19
    winscard_msg.c | 19
    winscard_msg.h | 17
    winscard_svc.c | 17
    winscard_svc.h | 17
    wintypes.h | 32 -
    44 files changed, 1617 insertions(+), 764 deletions(-)

    Changes:
    • integration of CACPlugin, CFlexPlugin, MCardPlugin and PKCS11 directories. pcsc-lite is now in its own PCSC directory
    • add the Apple license (Apple Public Source License Version 1.2) in each source code file
    • merge with pcsc-lite 1.2.0 rc1 (or a more recent version)
    • move from /usr/local/pcsc to /usr/libexec/SmartCardServices in hotplug_macosx.c plus other changes specific to Mac OS X
    It looks like Apple resynchronised with the "official" pcsc-lite at that time.

    10.4 Tiger

    April 2005
    Diffstat between 10.3 and 10.4.0 version
    $ diff -ru SmartCardServices-15 SmartCardServices-31 | diffstat 
     APPLE_LICENSE                      |  509 ++++++++---------
     Makefile.installPhase              |   45 +
     installPhase/man/pcscd.8           |   16
     installPhase/man/pcsctool.8        |    2
     src/CACPlugin/commonAccessCard.c   |   24
     src/CFlexPlugin/cryptoflex.c       |    3
     src/CFlexPlugin/cryptoflex.h       |    1
     src/MCardPlugin/musclecardApplet.c |   35 -
     src/PCSC/eventhandler.c            |    7
     src/PCSC/hotplug_macosx.c          | 1065 +++++++++++++++++++++----------------
     src/PCSC/mscdefines.h              |   29 -
     src/PCSC/musclecard.c              |   83 +-
     src/PCSC/musclecard.h              |   29 -
     src/PCSC/pcscdaemon.c              |   88 ++-
     src/PCSC/pcsclite.h                |   31 -
     src/PCSC/powermgt_macosx.c         |   25
     src/PCSC/readerfactory.c           |    4
     src/PCSC/tokenfactory.c            |   12
     src/PCSC/tokenfactory.h            |    5
     src/PCSC/winscard.c                |   38 -
     src/PCSC/winscard.h                |   29 -
     src/PCSC/winscard_clnt.c           |  387 +++++++------
     src/PCSC/winscard_msg.c            |  320 -----------
     src/PCSC/winscard_msg.h            |  203 +++----
     src/PCSC/winscard_svc.c            |  496 ++++++++++++++---
     src/PCSC/winscard_svc.h            |   65 ++
     src/PCSC/wintypes.h                |   29 -
     src/PKCS11/p11_crypt.c             |    3
     src/PKCS11/p11x_object.c           |    6
     29 files changed, 2016 insertions(+), 1573 deletions(-)

    Changes:
    • hotplug_macosx.c: iterate on all the interfaces of a USB device and other changes
    • client/server communication protocol: redesign the protocol to use a 2 parts header+body in the commands

    Diffstat between 10.4.0 and 10.4.11 PowerPC
    $ diff -ru SmartCardServices-31 SmartCardServices-27738 | diffstat
     SmartCardServices.xcode/project.pbxproj |   35
     src/PCSC/sys_generic.h                  |    4
     src/PCSC/sys_macosx.cpp                 |    7
     src/PCSC/sys_unix.c                     |    7
     src/PCSC/winscard_clnt.c                | 1127 +++++++++++++++-----------------
     src/PKCS11/p11x_prefs.c                 |   32
     6 files changed, 590 insertions(+), 622 deletions(-)

    Changes:
    • minor changes
    • a new function SYS_MUnmap is added and used in winscard_clnt.c. This function was never used in the "official" pcsc-lite.

    Diffstat between 10.4.11 PowerPC and 10.4.11 x86
    $ diff -ru SmartCardServices-27738 SmartCardServices-30487 | diffstat
     SmartCardServices.xcode/project.pbxproj                     |   55 +-
     installPhase/drivers/SCR24XHndlr.bundle/Contents/Info.plist |    2
     src/CACPlugin/commonAccessCard.c                            |    2
     src/CCIDDriver/USB/MacOSX/usbserial_mosx.c                  |   22
     src/CCIDDriver/USB/MacOSX/usbserial_mosx.h                  |    4
     src/CCIDDriver/common/CCID.c                                |    8
     src/CCIDDriver/common/CCIDPropExt.c                         |    2
     src/PCSC/debuglog.c                                         |   10
     src/PCSC/debuglog.h                                         |    2
     src/PCSC/eventhandler.c                                     |   42 -
     src/PCSC/hotplug_macosx.c                                   |  267 ++++++------
     src/PCSC/mscdefines.h                                       |   28 -
     src/PCSC/musclecard.c                                       |    4
     src/PCSC/musclecard.h                                       |    2
     src/PCSC/pcscdaemon.c                                       |   15
     src/PCSC/pcsclite.h                                         |   18
     src/PCSC/readerfactory.c                                    |   10
     src/PCSC/testpcsc.c                                         |   10
     src/PCSC/winscard.h                                         |   74 +--
     src/PCSC/winscard_clnt.c                                    |   92 ++--
     src/PCSC/winscard_msg.h                                     |   10
     src/PCSC/winscard_svc.c                                     |  122 +++++
     src/PCSC/winscard_svc.h                                     |    5
     src/PCSC/wintypes.h                                         |   26 -
     src/PKCS11/p11_crypt.c                                      |    8
     src/PKCS11/p11_key.c                                        |    5
     src/PKCS11/p11_sign.c                                       |   19
     27 files changed, 515 insertions(+), 349 deletions(-)

    Changes:
    • use of htonl() and ntohl() to convert between little and big endian integers
    • hotplug_macosx.c updated again
    • use of uint8_t, uint16_t, uint32_t types to support 32 and 64 bits client applications with the same pcscd server

    The major change here is the support of PowerPC and Intel CPUs at the same time.

    On an Intel Mac it is possible to run a PowerPC appplication using Rosetta. In that case the application code is for PowerPC but the PC/SC daemon is running x86 code (native code). The daemon needs to convert the byte order in all the messages exchanged between the client (PowerPC code) and server (x86 code).

    10.5 Leopard

    October 2007

    SmartCardServices-32672

    $ diff -ruN SmartCardServices-30487 SmartCardServices-32672 | diffstat
    Makefile.installPhase | 9
    SmartCardServices.xcode/project.pbxproj | 3277 ------------------------
    SmartCardServices.xcodeproj/project.pbxproj | 3030 ++++++++++++++++++++++
    installPhase/man/sc_auth.8 | 91
    installPhase/scripts/sc_auth | 148 +
    src/CCIDDriver/USB/MacOSX/usbserial_mosx.c | 4
    src/CCIDDriver/common/tools.c | 2
    src/PCSC/PCSC.exp | 71
    src/PCSC/PCSCDevice.cpp | 66
    src/PCSC/PCSCDevice.h | 100
    src/PCSC/PCSCDriverBundle.cpp | 261 +
    src/PCSC/PCSCDriverBundle.h | 125
    src/PCSC/PCSCDriverBundles.cpp | 97
    src/PCSC/PCSCDriverBundles.h | 76
    src/PCSC/atrhandler.c | 2
    src/PCSC/atrhandler.h | 2
    src/PCSC/config.h | 215 +
    src/PCSC/configfile.c | 4
    src/PCSC/configfile.l | 2
    src/PCSC/debug.c | 160 +
    src/PCSC/debug.h | 78
    src/PCSC/debuglog.c | 340 +-
    src/PCSC/debuglog.h | 157 -
    src/PCSC/eventhandler.c | 9
    src/PCSC/eventhandler.cpp | 533 +++
    src/PCSC/eventhandler.h | 72
    src/PCSC/hotplug.h | 86
    src/PCSC/hotplug_macosx.cpp | 151 +
    src/PCSC/ifdhandler.h | 123
    src/PCSC/ifdwrapper.c | 813 ++---
    src/PCSC/ifdwrapper.h | 73
    src/PCSC/musclecard.c | 52
    src/PCSC/pcscdaemon.c | 664 ++--
    src/PCSC/pcscdmonitor.cpp | 1129 ++++++++
    src/PCSC/pcscdmonitor.h | 191 +
    src/PCSC/pcscdserver.cpp | 137 +
    src/PCSC/pcscdserver.h | 101
    src/PCSC/pcscexport.h | 62
    src/PCSC/pcsclite.h | 402 +-
    src/PCSC/powermgt_macosx.c | 31
    src/PCSC/prothandler.c | 247 -
    src/PCSC/prothandler.h | 70
    src/PCSC/reader.cpp | 165 +
    src/PCSC/reader.h | 147 +
    src/PCSC/readerfactory.c | 2070 ++++++---------
    src/PCSC/readerfactory.h | 200 +
    src/PCSC/readerstate.cpp | 108
    src/PCSC/readerstate.h | 116
    src/PCSC/sys_generic.h | 108
    src/PCSC/sys_macosx.cpp | 222 -
    src/PCSC/sys_unix.c | 316 +-
    src/PCSC/testpcsc.c | 4
    src/PCSC/thread_generic.h | 26
    src/PCSC/thread_macosx.c | 38
    src/PCSC/tokenfactory.c | 16
    src/PCSC/tokenparser.c | 4
    src/PCSC/winscard.c | 1558 ++++++-----
    src/PCSC/winscard.h | 103
    src/PCSC/winscard_clnt.c | 3798 ++++++++++++++++++----------
    src/PCSC/winscard_msg.cpp | 1002 +++++++
    src/PCSC/winscard_msg.h | 458 ++-
    src/PCSC/winscard_msg_srv.c | 305 ++
    src/PCSC/winscard_svc.c | 1311 +++++----
    src/PCSC/winscard_svc.h | 136 -
    src/PCSC/wintypes.h | 56
    src/PCSC/xiodevices.cpp | 141 +
    src/PCSC/xiodevices.h | 70
    src/PKCS11/p11x_msc.c | 12
    68 files changed, 16622 insertions(+), 9131 deletions(-)

    Changes:
    • install the sc_auth command used to configure a smart card Mac OS X login
    • support colored logs but only on Linux terminals. Apple just reused debuglog.c from pcsc-lite 1.3.3
    • use secdebug() to log debug messages (visible using dtrace)
    • reuse ifdwrapper.c, prothandler.c and pcscdaemon.c from pcsc-lite 1.4.0
    • integrate with securityd
    • create new C++ files:
      • eventhandler.cpp
      • hotplug_macosx.cpp
      • PCSCDevice.cpp
      • pcscdmonitor.cpp
      • PCSCDriverBundle.cpp
      • PCSCDriverBundles.cpp
      • pcscdserver.cpp
      • reader.cpp
      • readerstate.cpp
      • sys_macosx.cpp
      • winscard_msg.cpp
      • xiodevices.cpp
    The detection and management of smart card readers is now a C++ code.

    The new file pcscdmonitor.cpp is the link with securityd.
    From the source code:
    pcscmonitor - use PCSC to monitor smartcard reader/card state for securityd

    PCSCDMonitor is the "glue" between PCSC and the securityd objects representing smartcard-related things. Its job is to manage the daemon and translate real-world events (such as card and device insertions) into the securityd object web.

    PCSCDMonitor uses multiple inheritance to the hilt. It is (among others)
      (*) A notification listener, to listen to pcscd state notifications
      (*) A MachServer::Timer, to handle timed actions
      (*) A NotificationPort::Receiver, to get IOKit notifications of device insertions

    This version of Apple pcsc-lite is a major deviation from the "official" pcsc-lite.
    At the same time Apple merged code from the "official" pcsc-lite.

    10.6 Snow Leopard

    August 2009

    SmartCardServices-36160

    $ diff -ruN SmartCardServices-32672/src/PCSC/ SmartCardServices-36160/src/PCSC/ | diffstat
     eventhandler.cpp   |   12 +-
     hotplug.h          |    4
     hotplug_macosx.cpp |   17 +++
     ifdwrapper.c       |   15 +--
     pcscdaemon.c       |  116 +++++++++++++++++------
     pcscdmonitor.cpp   |   96 ++++++++++++++-----
     readerfactory.c    |  141 +++++++++++++++++++++++++++-
     testpcsc.c         |   34 ++++--
     thread_macosx.c    |   23 ++--
     winscard.c         |  113 +++++++++++-----------
     winscard.h         |    2
     winscard_clnt.c    |  131 +++++++++++++++-----------
     winscard_msg.cpp   |  122 ++++++++++++------------
     winscard_msg.h     |  264 ++++++++++++++++++++++++++---------------------------
     winscard_msg_srv.c |   50 ++++++----
     winscard_svc.c     |   43 +++++++-
     16 files changed, 761 insertions(+), 422 deletions(-)

    Changes:
    • Apple removed the code of the CCID driver from SmartCardServices
    • Apple now provides my CCID driver instead of another (limited) CCID driver
    • this version of SmartCardServices includes patches I made in pcsc-lite 1.5.0 and I backported to the Apple version (ifdwrapper.c and winscard.c) since I am a member of the SmartCardServices project
    • support 32 and 64-bits smart card reader driver. pcscd will restart in 32-bits if a 32-bits only driver is found
    • use OSSwapHostToBigInt64() to support big/little endian conversion and also 32/64 bits conversion

    10.7 Lion

    July 2011

    See my blog article "Mac OS X Lion and smart cards status" for more details.

    SmartCardServices-55000

    $ diff -ru SmartCardServices-36160 SmartCardServices-55000 | diffstat
     Info-PCSC.plist                             |    2
     SmartCardServices.xcodeproj/project.pbxproj |  106 -
     src/PCSC/PCSCDevice.h                       |    1
     src/PCSC/PCSCDriverBundle.h                 |    1
     src/PCSC/atrhandler.c                       |  157 +
     src/PCSC/atrhandler.h                       |   49
     src/PCSC/configfile.c                       | 2406 ++++++++++++++--------------
     src/PCSC/configfile.h                       |    2
     src/PCSC/configfile.l                       |  211 +-
     src/PCSC/debug.c                            |   51
     src/PCSC/debug.h                            |    2
     src/PCSC/debuglog.c                         |  165 -
     src/PCSC/debuglog.h                         |    2
     src/PCSC/dyn_generic.h                      |    2
     src/PCSC/dyn_macosx.c                       |   26
     src/PCSC/eventhandler.cpp                   |    6
     src/PCSC/eventhandler.h                     |    2
     src/PCSC/hotplug.h                          |    2
     src/PCSC/hotplug_macosx.cpp                 |    1
     src/PCSC/ifdhandler.h                       |  798 +++++++--
     src/PCSC/ifdwrapper.c                       |  232 +-
     src/PCSC/ifdwrapper.h                       |    2
     src/PCSC/musclecard.h                       |    2
     src/PCSC/pcscdaemon.c                       |    2
     src/PCSC/pcscdmonitor.cpp                   |    4
     src/PCSC/pcscdmonitor.h                     |    1
     src/PCSC/pcscdserver.h                      |    1
     src/PCSC/pcscexport.h                       |    2
     src/PCSC/pcsclite.h                         |  127 -
     src/PCSC/powermgt_generic.h                 |    2
     src/PCSC/prothandler.c                      |    2
     src/PCSC/prothandler.h                      |    2
     src/PCSC/reader.h                           |  340 ++-
     src/PCSC/readerfactory.c                    |   12
     src/PCSC/readerfactory.h                    |    2
     src/PCSC/readerstate.h                      |    1
     src/PCSC/sys_generic.h                      |    2
     src/PCSC/sys_macosx.cpp                     |    3
     src/PCSC/sys_unix.c                         |    2
     src/PCSC/thread_macosx.c                    |    2
     src/PCSC/tokenfactory.c                     |    2
     src/PCSC/utils/bundleTool.c                 |    2
     src/PCSC/winscard.c                         |    2
     src/PCSC/winscard.h                         |    2
     src/PCSC/winscard_clnt.c                    |    2
     src/PCSC/winscard_msg.c                     |    2
     src/PCSC/winscard_msg.cpp                   |    2
     src/PCSC/winscard_msg.h                     |    2
     src/PCSC/winscard_msg_srv.c                 |    2
     src/PCSC/winscard_svc.c                     |   10
     src/PCSC/winscard_svc.h                     |    2
     src/PCSC/wintypes.h                         |   16
     52 files changed, 2727 insertions(+), 2054 deletions(-)

    Changes:
    • some bugs fixes I made in the "official" pcsc-lite and I then ported to Apple version of pcsc-lite. See my blog article for details.
    • the CCID driver has been updated from 1.3.8 to 1.3.11
    I integrated the changes in SmartCardServices in July 2009 and they were available two years later in the next major version of Mac OS X.

    10.8 Mountain Lion

    July 2012

    Blog article "Mac OS X Mountain Lion and smart card status"

    SmartCardServices-55105

    No change in the source code.

    10.9 Mavericks

    October 2013

    Blog article "OS X Mavericks and smart cards status"

    SmartCardServices-55111

    Changes:
    • The ability to respawn in 32-bits to run a 32-bits only driver (introduced in Snow Leopard) has been removed
    • The CCID driver is now in 64-bits but the version is still 1.3.11

    Conclusion

    The evolution of Apple pcsc-lite is quite different from the evolution of the "official" pcsc-lite.

    In a next article I will describe the differences between the 2 projects after more than 10 years of evolution.
    Previous
    Next Post »