This keeps track of a list of currently available reader structures. More...

#include "config.h"
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <unistd.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <errno.h>
#include <fcntl.h>
#include <pthread.h>
#include <stdatomic.h>
#include <stdbool.h>
#include "misc.h"
#include "pcscd.h"
#include "debuglog.h"
#include "readerfactory.h"
#include "dyn_generic.h"
#include "sys_generic.h"
#include "eventhandler.h"
#include "readers.h"
#include "ifdwrapper.h"
#include "hotplug.h"
#include "configfile.h"
#include "utils.h"

Macros
#define	INITIAL_MAX_READERS_CONTEXTS 2
#define	GET_ADDRESS_OPTIONALv2(s, code)
#define	GET_ADDRESSv2(s)
#define	GET_ADDRESS_OPTIONALv3(s, code)
#define	GET_ADDRESSv3(s)

Functions
static LONG	removeReader (READER_CONTEXT *sReader)
static int	RDR_CLIHANDLES_seeker (const void el, const void key)
LONG	_RefReader (READER_CONTEXT *sReader)
LONG	_UnrefReader (READER_CONTEXT *sReader)
LONG	RFAllocateReaderSpace (unsigned int customMaxReaderHandles)
static LONG	RFReAllocateReaderSpace (void)
LONG	RFAddReader (const char readerNameLong, int port, const char library, const char *device)
LONG	RFRemoveReader (const char *readerName, int port, int flags)
LONG	RFSetReaderName (READER_CONTEXT rContext, const char readerName, const char *libraryName, int port)
LONG	RFReaderInfo (const char readerName, READER_CONTEXT *sReader)
LONG	RFReaderInfoById (SCARDHANDLE hCard, READER_CONTEXT **sReader)
LONG	RFLoadReader (READER_CONTEXT *rContext)
LONG	RFBindFunctions (READER_CONTEXT *rContext)
LONG	RFUnBindFunctions (READER_CONTEXT *rContext)
LONG	RFUnloadReader (READER_CONTEXT *rContext)
LONG	RFCheckSharing (SCARDHANDLE hCard, READER_CONTEXT *rContext)
LONG	RFLockSharing (SCARDHANDLE hCard, READER_CONTEXT *rContext)
LONG	RFUnlockSharing (SCARDHANDLE hCard, READER_CONTEXT *rContext)
LONG	RFUnlockAllSharing (SCARDHANDLE hCard, READER_CONTEXT *rContext)
LONG	RFInitializeReader (READER_CONTEXT *rContext)
void	RFUnInitializeReader (READER_CONTEXT *rContext)
SCARDHANDLE	RFCreateReaderHandle (READER_CONTEXT *rContext)
LONG	RFAddReaderHandle (READER_CONTEXT *rContext, SCARDHANDLE hCard)
LONG	RFRemoveReaderHandle (READER_CONTEXT *rContext, SCARDHANDLE hCard)
void	RFSetReaderEventState (READER_CONTEXT *rContext, DWORD dwEvent)
LONG	RFCheckReaderEventState (READER_CONTEXT *rContext, SCARDHANDLE hCard)
LONG	RFClearReaderEventState (READER_CONTEXT *rContext, SCARDHANDLE hCard)
LONG	RFCheckReaderStatus (READER_CONTEXT *rContext)
void	RFCleanupReaders (void)
int	RFGetPowerState (READER_CONTEXT *rContext)
	Wait until all connected readers have a chance to power up a possibly inserted card.
void	RFSetPowerState (READER_CONTEXT *rContext, int value)

Variables
int	pcsclite_max_reader_context = -1
READER_CONTEXT **	sReadersContexts
static int	maxReaderHandles = PCSC_MAX_READER_HANDLES
static pthread_mutex_t	LockMutex = PTHREAD_MUTEX_INITIALIZER
int16_t	ReaderEvents = 1

Detailed Description

This keeps track of a list of currently available reader structures.

Definition in file readerfactory.c.

Macro Definition Documentation

◆ GET_ADDRESS_OPTIONALv2

#define GET_ADDRESS_OPTIONALv2	(		s,
			code )

Value:

{ \
    void *f1 = NULL; \
    int rvl = DYN_GetAddress(rContext->vHandle, &f1, "IFDH" #s, false); \
    if (SCARD_S_SUCCESS != rvl) \
    { \
        code \
    } \
    rContext->psFunctions.psFunctions_v2.pvf ## s = f1; \
}

◆ GET_ADDRESS_OPTIONALv3

#define GET_ADDRESS_OPTIONALv3	(		s,
			code )

Value:

{ \
    void *f1 = NULL; \
    int rvl = DYN_GetAddress(rContext->vHandle, &f1, "IFDH" #s, false); \
    if (SCARD_S_SUCCESS != rvl) \
    { \
        code \
    } \
    rContext->psFunctions.psFunctions_v3.pvf ## s = f1; \
}

◆ GET_ADDRESSv2

#define GET_ADDRESSv2 ( s )

Value:

GET_ADDRESS_OPTIONALv2(s, \
    Log1(PCSC_LOG_CRITICAL, "IFDHandler functions missing: " #s ); \
    return(rv); )

◆ GET_ADDRESSv3

#define GET_ADDRESSv3 ( s )

Value:

GET_ADDRESS_OPTIONALv3(s, \
    Log1(PCSC_LOG_CRITICAL, "IFDHandler functions missing: " #s ); \
    return(rv); )

◆ INITIAL_MAX_READERS_CONTEXTS

#define INITIAL_MAX_READERS_CONTEXTS 2

Definition at line 68 of file readerfactory.c.

Function Documentation

◆ _RefReader()

LONG _RefReader ( READER_CONTEXT * sReader )

Definition at line 101 of file readerfactory.c.

◆ _UnrefReader()

LONG _UnrefReader ( READER_CONTEXT * sReader )

Definition at line 111 of file readerfactory.c.

◆ RDR_CLIHANDLES_seeker()

int RDR_CLIHANDLES_seeker	(	const void *	el,
		const void *	key )

static

Definition at line 82 of file readerfactory.c.

◆ removeReader()

LONG removeReader ( READER_CONTEXT * sReader )

static

Definition at line 672 of file readerfactory.c.

◆ RFAddReader()

LONG RFAddReader	(	const char *	readerNameLong,
		int	port,
		const char *	library,
		const char *	device )

Definition at line 191 of file readerfactory.c.

◆ RFAddReaderHandle()

LONG RFAddReaderHandle	(	READER_CONTEXT *	rContext,
		SCARDHANDLE	hCard )

Definition at line 1243 of file readerfactory.c.

◆ RFAllocateReaderSpace()

LONG RFAllocateReaderSpace ( unsigned int customMaxReaderHandles )

Definition at line 124 of file readerfactory.c.

◆ RFBindFunctions()

LONG RFBindFunctions ( READER_CONTEXT * rContext )

Definition at line 928 of file readerfactory.c.

◆ RFCheckReaderEventState()

LONG RFCheckReaderEventState	(	READER_CONTEXT *	rContext,
		SCARDHANDLE	hCard )

Definition at line 1348 of file readerfactory.c.

◆ RFCheckReaderStatus()

LONG RFCheckReaderStatus ( READER_CONTEXT * rContext )

Definition at line 1405 of file readerfactory.c.

◆ RFCheckSharing()

LONG RFCheckSharing	(	SCARDHANDLE	hCard,
		READER_CONTEXT *	rContext )

Definition at line 1053 of file readerfactory.c.

◆ RFCleanupReaders()

void RFCleanupReaders ( void )

Definition at line 1413 of file readerfactory.c.

◆ RFClearReaderEventState()

LONG RFClearReaderEventState	(	READER_CONTEXT *	rContext,
		SCARDHANDLE	hCard )

Definition at line 1386 of file readerfactory.c.

◆ RFCreateReaderHandle()

SCARDHANDLE RFCreateReaderHandle ( READER_CONTEXT * rContext )

Definition at line 1213 of file readerfactory.c.

◆ RFGetPowerState()

int RFGetPowerState ( READER_CONTEXT * rContext )

Wait until all connected readers have a chance to power up a possibly inserted card.

Definition at line 1623 of file readerfactory.c.

◆ RFInitializeReader()

LONG RFInitializeReader ( READER_CONTEXT * rContext )

Definition at line 1126 of file readerfactory.c.

◆ RFLoadReader()

LONG RFLoadReader ( READER_CONTEXT * rContext )

Definition at line 911 of file readerfactory.c.

◆ RFLockSharing()

LONG RFLockSharing	(	SCARDHANDLE	hCard,
		READER_CONTEXT *	rContext )

Definition at line 1061 of file readerfactory.c.

◆ RFReaderInfo()

LONG RFReaderInfo	(	const char *	readerName,
		READER_CONTEXT **	sReader )

Definition at line 858 of file readerfactory.c.

◆ RFReaderInfoById()

LONG RFReaderInfoById	(	SCARDHANDLE	hCard,
		READER_CONTEXT **	sReader )

Definition at line 884 of file readerfactory.c.

◆ RFReAllocateReaderSpace()

LONG RFReAllocateReaderSpace ( void )

static

Definition at line 159 of file readerfactory.c.

◆ RFRemoveReader()

LONG RFRemoveReader	(	const char *	readerName,
		int	port,
		int	flags )

Definition at line 608 of file readerfactory.c.

◆ RFRemoveReaderHandle()

LONG RFRemoveReaderHandle	(	READER_CONTEXT *	rContext,
		SCARDHANDLE	hCard )

Definition at line 1286 of file readerfactory.c.

◆ RFSetPowerState()

void RFSetPowerState	(	READER_CONTEXT *	rContext,
		int	value )

Definition at line 1631 of file readerfactory.c.

◆ RFSetReaderEventState()

void RFSetReaderEventState	(	READER_CONTEXT *	rContext,
		DWORD	dwEvent )

Definition at line 1315 of file readerfactory.c.

◆ RFSetReaderName()

LONG RFSetReaderName	(	READER_CONTEXT *	rContext,
		const char *	readerName,
		const char *	libraryName,
		int	port )

Definition at line 743 of file readerfactory.c.

◆ RFUnBindFunctions()

LONG RFUnBindFunctions ( READER_CONTEXT * rContext )

Definition at line 1030 of file readerfactory.c.

◆ RFUnInitializeReader()

void RFUnInitializeReader ( READER_CONTEXT * rContext )

Definition at line 1184 of file readerfactory.c.

◆ RFUnloadReader()

LONG RFUnloadReader ( READER_CONTEXT * rContext )

Definition at line 1038 of file readerfactory.c.

◆ RFUnlockAllSharing()

LONG RFUnlockAllSharing	(	SCARDHANDLE	hCard,
		READER_CONTEXT *	rContext )

Definition at line 1110 of file readerfactory.c.

◆ RFUnlockSharing()

LONG RFUnlockSharing	(	SCARDHANDLE	hCard,
		READER_CONTEXT *	rContext )

Definition at line 1077 of file readerfactory.c.

Variable Documentation

◆ LockMutex

pthread_mutex_t LockMutex = PTHREAD_MUTEX_INITIALIZER

static

Definition at line 77 of file readerfactory.c.

◆ maxReaderHandles

int maxReaderHandles = PCSC_MAX_READER_HANDLES

static

Definition at line 72 of file readerfactory.c.

◆ pcsclite_max_reader_context

int pcsclite_max_reader_context = -1

Definition at line 70 of file readerfactory.c.

◆ ReaderEvents

int16_t ReaderEvents = 1

Definition at line 78 of file readerfactory.c.

◆ sReadersContexts

READER_CONTEXT** sReadersContexts

Definition at line 71 of file readerfactory.c.

Macros

Functions

Variables

Detailed Description

Macro Definition Documentation

◆ GET_ADDRESS_OPTIONALv2

◆ GET_ADDRESS_OPTIONALv3

◆ GET_ADDRESSv2

◆ GET_ADDRESSv3

◆ INITIAL_MAX_READERS_CONTEXTS

Function Documentation

◆ _RefReader()

◆ _UnrefReader()

◆ RDR_CLIHANDLES_seeker()

◆ removeReader()

◆ RFAddReader()

◆ RFAddReaderHandle()

◆ RFAllocateReaderSpace()

◆ RFBindFunctions()

◆ RFCheckReaderEventState()

◆ RFCheckReaderStatus()

◆ RFCheckSharing()

◆ RFCleanupReaders()

◆ RFClearReaderEventState()

◆ RFCreateReaderHandle()

◆ RFGetPowerState()

◆ RFInitializeReader()

◆ RFLoadReader()

◆ RFLockSharing()

◆ RFReaderInfo()

◆ RFReaderInfoById()

◆ RFReAllocateReaderSpace()

◆ RFRemoveReader()

◆ RFRemoveReaderHandle()

◆ RFSetPowerState()

◆ RFSetReaderEventState()

◆ RFSetReaderName()

◆ RFUnBindFunctions()

◆ RFUnInitializeReader()

◆ RFUnloadReader()

◆ RFUnlockAllSharing()

◆ RFUnlockSharing()

Variable Documentation

◆ LockMutex

◆ maxReaderHandles

◆ pcsclite_max_reader_context

◆ ReaderEvents

◆ sReadersContexts