PCSCLITE_FILTER_IGNORE_READER_NAMES and PCSCLITE_FILTER_EXTEND_READER_NAMES--enable-filter.PCSCLITE_FILTER_IGNORE_READER_NAMES is defined then it contains a list of patterns separated by the character ":".PCSCLITE_FILTER_IGNORE_READER_NAMES as: "Contactless".PCSCLITE_FILTER_EXTEND_READER_NAMES is defined then it contains a string that will be added at the end of the PC/SC reader names.$HOSTNAME. If you want to have a space character between the PC/SC reader name and host name you define PCSCLITE_FILTER_EXTEND_READER_NAMES as:" $HOSTNAME".NAME=pcscd # Read configuration variable file if it is present [ -r /etc/default/$NAME ] && . /etc/default/$NAME
PCSCLITE_FILTER_IGNORE_READER_NAMES="Contactless" PCSCLITE_FILTER_EXTEND_READER_NAMES=" $HOSTNAME"And you are good to go.
"\\?PnP?\Notification".To wait for a reader event (reader added or removed) you may use the special reader nameWith this feature it is possible to detect that a smart card reader has been added or removed to the system without polling with calls to SCardListReaders() in a loop."\\?PnP?\Notification".
If a reader event occurs the state of this reader will change and the bit SCARD_STATE_CHANGED will be set.
#include <stdio.h> #ifdef __APPLE__ #include <PCSC/winscard.h> #include <PCSC/wintypes.h> #else #include <winscard.h> #endif int main(void) { SCARDCONTEXT hContext; LPSTR mszReaders; DWORD err = SCardEstablishContext(SCARD_SCOPE_SYSTEM, NULL, NULL, &hContext); if (err != SCARD_S_SUCCESS) { printf("ScardEstablishedContext: 0x%08x\n",err); return -1; } SCARD_READERSTATE rgReaderStates[1]; rgReaderStates[0].szReader = "\\\\?PnP?\\Notification"; rgReaderStates[0].dwCurrentState = SCARD_STATE_UNAWARE; rgReaderStates[0].dwEventState = SCARD_STATE_UNKNOWN; err = SCardGetStatusChange(hContext, 10, rgReaderStates, 1); printf("SCardGetStatusChange: %s (0x%08X)\n", pcsc_stringify_error(err), err); printf("dwEventState: %X\n", rgReaderStates[0].dwEventState); if (rgReaderStates[0].dwEventState & SCARD_STATE_UNKNOWN) printf("\\\\?PnP?\\Notification is NOT supported\n"); else printf("\\\\?PnP?\\Notification IS supported\n"); SCardReleaseContext(hContext); return 0; }
$ CFLAGS="-framework PCSC" make main cc -framework PCSC main.c -o main
$ ./main SCardGetStatusChange: Command successful. (0x00000000) dwEventState: 6 \\?PnP?\Notification is NOT supportedThe returned value for dwEventState is 6 and correspond to SCARD_STATE_CHANGED (2) + SCARD_STATE_UNKNOWN (4). PC/SC indicates that the reader
"\\?PnP?\Notification" is unknown.SCardGetStatusChange() returns SCARD_S_SUCCESS and also waited for the indicated time, here 10 ms but you can increase the value to make the test more explicit.SCARD_E_TIMEOUT). Yes, it is a bug in the PC/SC layer.$ CFLAGS=`pkg-config --cflags libpcsclite` LDFLAGS=`pkg-config --libs libpcsclite` make main cc -pthread -I/usr/include/PCSC -lpcsclite main.c -o main
$ ./main SCardGetStatusChange: Command timeout. (0x8010000A) dwEventState: 0 \\?PnP?\Notification IS supportedHere the command returns after the delay has expired because no reader has been connected or removed. The returned value is
SCARD_E_TIMEOUT.SCARD_STATE_CHANGED for this reader."\\?PnP?\Notification" one day.
dwEventState.This behaviour is also present in PC/SC on Windows.dwEventStatealso contains a number of events in the upper 16 bits (dwEventState& 0xFFFF0000). This number of events is incremented for each card insertion or removal in the specified reader. This can be used to detect a card removal/insertion between two calls toSCardGetStatusChange().
SCardGetStatusChange() was running. Potentially the inserted card is not the same as the removed card so the PC/SC application may have to build a new applicative context for the new card.#! /usr/bin/env python from smartcard.scard import * from smartcard.pcsc.PCSCExceptions import * def parseEventState(eventstate): stateList = list() states = {SCARD_STATE_IGNORE: "Ignore", SCARD_STATE_CHANGED: "Changed", SCARD_STATE_UNKNOWN: "Unknown", SCARD_STATE_UNAVAILABLE: "Unavailable", SCARD_STATE_EMPTY: "Empty", SCARD_STATE_PRESENT: "Present", SCARD_STATE_ATRMATCH: "ATR match", SCARD_STATE_EXCLUSIVE: "Exclusive", SCARD_STATE_INUSE: "In use", SCARD_STATE_MUTE: "Mute"} for state in states: if eventstate & state: stateList.append(states[state]) return stateList hresult, hcontext = SCardEstablishContext(SCARD_SCOPE_USER) if hresult != SCARD_S_SUCCESS: raise EstablishContextException(hresult) hresult, readers = SCardListReaders(hcontext, []) if hresult != SCARD_S_SUCCESS: raise ListReadersException(hresult) print 'PC/SC Readers:', readers readerstates = {} for reader in readers: readerstates[reader] = (reader, SCARD_STATE_UNAWARE) hresult, newstates = SCardGetStatusChange(hcontext, 0, readerstates.values()) if hresult != SCARD_S_SUCCESS: raise BaseSCardException(hresult) print newstates for readerState in newstates: readername, eventstate, atr = readerState readerstates[readername] = (readername, eventstate) print "Move the smart card" ok = True while ok: try: hresult, newstates = SCardGetStatusChange(hcontext, INFINITE, newstates) if hresult != SCARD_S_SUCCESS and hresult != SCARD_E_TIMEOUT: raise BaseSCardException(hresult) except KeyboardInterrupt: ok = False for readerState in newstates: readername, eventstate, atr = readerState states = parseEventState(eventstate) print states, hex(eventstate) hresult = SCardReleaseContext(hcontext) print "SCardReleaseContext()", SCardGetErrorMessage(hresult) if hresult != SCARD_S_SUCCESS: raise ReleaseContextException(hresult)
$ ./SCardGetStatusChange.py
PC/SC Readers: ['Gemalto PC Twin Reader']
[('Gemalto PC Twin Reader', 18, [])]
Move the smart card
['Changed', 'Present'] 0x22
['Empty', 'Changed'] 0x12
['Changed', 'Present'] 0x22
['Empty', 'Changed'] 0x12
^C['Empty', 'Changed'] 0x12
SCardReleaseContext() Command successful.
$ ./SCardGetStatusChange.py
PC/SC Readers: ['Gemalto PC Twin Reader 00 00']
[('Gemalto PC Twin Reader 00 00', 18, [])]
Move the smart card
['Changed', 'Present'] 0x10022
['Empty', 'Changed'] 0x20012
['Changed', 'Present'] 0x30022
['Empty', 'Changed'] 0x40012
^C['Empty', 'Changed'] 0x40012
SCardReleaseContext() Command successful.
eventstate displayed (in hexadecimal).SCARD_STATE_CHANGED and SCARD_STATE_PRESENT) but you know that the card has been removed and inserted.None known.
Apple just answered to my bug report, now called feedback. The bug report #23937633 is now known as FB7531166. Apple answer is (I have it in French in my Feedback Assistant application. Surprising!):
"Thank you for your review and patience. We apologize for the late response. We do not intend to treat this report as an enhancement.
Indeed, adding new features to the existing PC/SC interface is not on the agenda. However, we will consider this suggestion in case our plans change."
Apple is reviewing (old) PC/SC issues. Nice to know.
But do not plan to add new features.
SCardBeginTransaction() returns SCARD_W_RESET_CARD if the card has been removed and inserted again in the reader.SCardBeginTransaction() returns SCARD_W_REMOVED_CARD instead.SCardBeginTransaction() returns SCARD_W_UNPOWERED_CARD on Mac OS X El Capitan if the card has been powered off by another application.SCardBeginTransaction() returns SCARD_W_RESET_CARD instead.#include <stdio.h> #include <stdlib.h> #include <string.h> #ifdef __APPLE__ #include <PCSC/winscard.h> #include <PCSC/wintypes.h> #else #include <winscard.h> #endif #define pcsc_error(fct) printf(fct ": %s 0x%08lX\n", pcsc_stringify_error(err), (long)err) int main(void) { LPSTR mszReaders; DWORD err, cchReaders = 0; SCARDCONTEXT hContext = 0; SCARDHANDLE hCard = 0; err = SCardEstablishContext(SCARD_SCOPE_SYSTEM, NULL, NULL, &hContext); if (err != SCARD_S_SUCCESS) { pcsc_error("ScardEstablishedContext"); return -1; } err = SCardListReaders(hContext, NULL, NULL, &cchReaders); if (err != 0) { pcsc_error("ScardListReaders"); return -1; } mszReaders = calloc(cchReaders, sizeof(char)); if (!mszReaders) { printf("calloc\n"); return -1; } err = SCardListReaders(hContext,NULL, mszReaders, &cchReaders); if (err != SCARD_S_SUCCESS) { pcsc_error("ScardListReaders"); return -1; } printf("Using reader: %s\n", mszReaders); DWORD dwActiveProtocol; err = SCardConnect(hContext, mszReaders, SCARD_SHARE_SHARED, SCARD_PROTOCOL_T0 | SCARD_PROTOCOL_T1, &hCard, &dwActiveProtocol); if (err != SCARD_S_SUCCESS) { pcsc_error("SCardConnect"); return 0; } printf("Remove and insert the card. Then press enter\n"); getchar(); err = SCardBeginTransaction(hCard); if (err != SCARD_S_SUCCESS) pcsc_error("SCardBeginTransaction"); err = SCardDisconnect(hCard, SCARD_LEAVE_CARD); if (err != SCARD_S_SUCCESS) pcsc_error("SCardDisconnect"); SCardReleaseContext(hContext); return 0; }
#! /usr/bin/env python from smartcard.System import readers from smartcard.scard import SCARD_UNPOWER_CARD, SCARD_RESET_CARD reader = readers()[0] print "Using:", reader connection = reader.createConnection() #connection.connect(disposition=SCARD_RESET_CARD) connection.connect(disposition=SCARD_UNPOWER_CARD)
disposition=SCARD_RESET_CARD then SCardBeginTransaction() will return SCARD_W_RESET_CARD as is also the case on GNU/Linux and Windows.$ CFLAGS="-framework PCSC" make main cc -framework PCSC main.c -o main
$ ./main Using reader: Gemalto PC Twin Reader Remove and insert the card. Then press enter SCardBeginTransaction: Card was reset. 0x80100068
$ ./main Using reader: Gemalto PC Twin Reader Remove and insert the card. Then press enter SCardBeginTransaction: Card is unpowered. 0x80100067
$ CFLAGS=`pkg-config --cflags libpcsclite` LDFLAGS=`pkg-config --libs libpcsclite` make main cc -pthread -I/usr/include/PCSC -lpcsclite main.c -o main
$ ./main Using reader: Gemalto PC Twin Reader 00 00 Remove and insert the card. Then press enter SCardBeginTransaction: Card was removed. 0x80100069
$ ./main Using reader: Gemalto PC Twin Reader 00 00 Remove and insert the card. Then press enter SCardBeginTransaction: Card was reset. 0x80100068
