server_l.h File Reference

#include <gwenhywfar/plugin.h>
#include <gwenhywfar/ipc.h>
#include <gwenhywfar/requestmgr.h>
#include <gwenhywfar/inherit.h>
#include <gwenhywfar/db.h>
#include <gwenhywfar/buffer.h>
#include <gwenhywfar/netlayer.h>
#include <chipcard2/chipcard2.h>
#include "common/card.h"
#include "connection_l.h"
#include "devicemanager/devicemanager_l.h"

Include dependency graph for chipcard2-server/server2/server_l.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Defines
#define	LCS_PLUGIN_DRIVER   "Libchipcard2_Driver"
#define	LCS_PLUGIN_SERVICE   "Libchipcard2_Service"
#define	LCS_DEFAULT_DHFILE   "chipcardd-dh.pem"
#define	LCS_DEFAULT_CERTFILE   "chipcardd-cert.pem"
#define	LCS_IPC_URL   "/libchipcard2/server"
#define	LCS_PATH_DESTLIB   "libchipcard2"
#define	LCS_PATH_DRIVER_INFODIR   "DriverInfoDir"
#define	LCS_PATH_DRIVER_EXECDIR   "DriverExecDir"
#define	LCS_PATH_SERVICE_EXECDIR   "ServiceExecDir"
#define	LCS_PATH_SERVER_DATADIR   "DataDir"
#define	LCS_PATH_SERVER_NEWCERTDIR   "NewCertDir"
#define	LCS_PATH_SERVER_TRUSTEDCERTDIR   "TrustedCertDir"
#define	LCS_PATH_SERVER_LOGDIR   "LogDir"
#define	LCS_REGKEY_BASE   "Software\\Libchipcard2\\Server\\Paths"
Typedefs
typedef struct LCS_SERVER	LCS_SERVER
typedef void(*	LCS_SERVER_DRIVER_CHG_FN )(LCS_SERVER *cs, GWEN_TYPE_UINT32 did, const char *driverType, const char *driverName, const char *libraryFile, LC_DRIVER_STATUS newSt, const char *reason)
typedef void(*	LCS_SERVER_READER_CHG_FN )(LCS_SERVER *cs, GWEN_TYPE_UINT32 did, GWEN_TYPE_UINT32 rid, const char *readerType, const char *readerName, const char *readerInfo, LC_READER_STATUS newSt, const char *reason)
typedef void(*	LCS_SERVER_NEWCARD_FN )(LCS_SERVER *cs, LCCO_CARD *card)
typedef void(*	LCS_SERVER_CARDREMOVED_FN )(LCS_SERVER *cs, GWEN_TYPE_UINT32 rid, int slotNum, GWEN_TYPE_UINT32 cardNum)
typedef int(*	LCS_SERVER_HANDLEREQUEST_FN )(LCS_SERVER *cs, GWEN_TYPE_UINT32 rid, const char *name, GWEN_DB_NODE *dbReq)
typedef void(*	LCS_SERVER_CONNECTION_DOWN_FN )(LCS_SERVER *cs, GWEN_NETLAYER *conn)
typedef void(*	LCS_SERVER_SERVICE_CHG_FN )(LCS_SERVER *cs, GWEN_TYPE_UINT32 sid, const char *serviceType, const char *serviceName, LC_SERVICE_STATUS newSt, const char *reason)
Functions
LCS_SERVER *	LCS_Server_new ()
void	LCS_Server_free (LCS_SERVER *cs)
int	LCS_Server_Init (LCS_SERVER *cs, GWEN_DB_NODE *db)
int	LCS_Server_Fini (LCS_SERVER *cs, GWEN_DB_NODE *db)
int	LCS_Server_Work (LCS_SERVER *cs)
void	LCS_Server_BeginUseReaders (LCS_SERVER *cs)
void	LCS_Server_EndUseReaders (LCS_SERVER *cs, int count)
LCS_SERVER_DRIVER_CHG_FN	LCS_Server_SetDriverChgFn (LCS_SERVER *cs, LCS_SERVER_DRIVER_CHG_FN f)
LCS_SERVER_READER_CHG_FN	LCS_Server_SetReaderChgFn (LCS_SERVER *cs, LCS_SERVER_READER_CHG_FN f)
LCS_SERVER_NEWCARD_FN	LCS_Server_SetNewCardFn (LCS_SERVER *cs, LCS_SERVER_NEWCARD_FN f)
LCS_SERVER_CARDREMOVED_FN	LCS_Server_SetCardRemovedFn (LCS_SERVER *cs, LCS_SERVER_CARDREMOVED_FN f)
LCS_SERVER_HANDLEREQUEST_FN	LCS_Server_SetHandleRequestFn (LCS_SERVER *cs, LCS_SERVER_HANDLEREQUEST_FN f)
LCS_SERVER_CONNECTION_DOWN_FN	LCS_Server_SetConnectionDownFn (LCS_SERVER *cs, LCS_SERVER_CONNECTION_DOWN_FN f)
LCS_SERVER_SERVICE_CHG_FN	LCS_Server_SetServiceChgFn (LCS_SERVER *cs, LCS_SERVER_SERVICE_CHG_FN f)
void	LCS_Server_UseConnectionFor (LCS_SERVER *cs, GWEN_NETLAYER *conn, LCS_CONNECTION_TYPE t, GWEN_TYPE_UINT32 ipcId)
GWEN_IPCMANAGER *	LCS_Server_GetIpcManager (const LCS_SERVER *cs)
GWEN_IPC_REQUEST_MANAGER *	LCS_Server_GetRequestManager (const LCS_SERVER *cs)
LCDM_DEVICEMANAGER *	LCS_Server_GetDeviceManager (const LCS_SERVER *cs)
void	LCS_Server_SetDeviceManager (LCS_SERVER *cs, LCDM_DEVICEMANAGER *dm)
int	LCS_Server_ReplaceVar (const char *path, const char *var, const char *value, GWEN_BUFFER *nbuf)
int	LCS_Server_SendErrorResponse (LCS_SERVER *cs, GWEN_TYPE_UINT32 rid, int code, const char *text)
void	LCS_Server_DumpState (const LCS_SERVER *cs)
Functions Called by other managers
void	LCS_Server_DriverChg (LCS_SERVER *cs, GWEN_TYPE_UINT32 did, const char *driverType, const char *driverName, const char *libraryFile, LC_DRIVER_STATUS newSt, const char *reason)
void	LCS_Server_ReaderChg (LCS_SERVER *cs, GWEN_TYPE_UINT32 did, GWEN_TYPE_UINT32 rid, const char *readerType, const char *readerName, const char *readerInfo, LC_READER_STATUS newSt, const char *reason)
void	LCS_Server_NewCard (LCS_SERVER *cs, LCCO_CARD *card)
void	LCS_Server_CardRemoved (LCS_SERVER *cs, GWEN_TYPE_UINT32 rid, int slotNum, GWEN_TYPE_UINT32 cardNum)
void	LCS_Server_ConnectionDown (LCS_SERVER *cs, GWEN_NETLAYER *conn)
void	LCS_Server_ServiceChg (LCS_SERVER *cs, GWEN_TYPE_UINT32 sid, const char *serviceType, const char *serviceName, LC_SERVICE_STATUS newSt, const char *reason)

---

Define Documentation

#define LCS_DEFAULT_CERTFILE   "chipcardd-cert.pem"

#define LCS_DEFAULT_DHFILE   "chipcardd-dh.pem"

defaults

#define LCS_IPC_URL   "/libchipcard2/server"

#define LCS_PATH_DESTLIB   "libchipcard2"

paths

#define LCS_PATH_DRIVER_EXECDIR   "DriverExecDir"

#define LCS_PATH_DRIVER_INFODIR   "DriverInfoDir"

#define LCS_PATH_SERVER_DATADIR   "DataDir"

#define LCS_PATH_SERVER_LOGDIR   "LogDir"

#define LCS_PATH_SERVER_NEWCERTDIR   "NewCertDir"

#define LCS_PATH_SERVER_TRUSTEDCERTDIR   "TrustedCertDir"

#define LCS_PATH_SERVICE_EXECDIR   "ServiceExecDir"

#define LCS_PLUGIN_DRIVER   "Libchipcard2_Driver"

If this name is changed it must be changed in all plugin description files of the drivers!

#define LCS_PLUGIN_SERVICE   "Libchipcard2_Service"

If this name is changed it must be changed in all plugin description files of the services!

#define LCS_REGKEY_BASE   "Software\\Libchipcard2\\Server\\Paths"

---

Typedef Documentation

typedef struct LCS_SERVER LCS_SERVER

typedef void(* LCS_SERVER_CARDREMOVED_FN)(LCS_SERVER *cs, GWEN_TYPE_UINT32 rid, int slotNum, GWEN_TYPE_UINT32 cardNum)

typedef void(* LCS_SERVER_CONNECTION_DOWN_FN)(LCS_SERVER *cs, GWEN_NETLAYER *conn)

typedef void(* LCS_SERVER_DRIVER_CHG_FN)(LCS_SERVER *cs, GWEN_TYPE_UINT32 did, const char *driverType, const char *driverName, const char *libraryFile, LC_DRIVER_STATUS newSt, const char *reason)

typedef int(* LCS_SERVER_HANDLEREQUEST_FN)(LCS_SERVER *cs, GWEN_TYPE_UINT32 rid, const char *name, GWEN_DB_NODE *dbReq)

typedef void(* LCS_SERVER_NEWCARD_FN)(LCS_SERVER *cs, LCCO_CARD *card)

typedef void(* LCS_SERVER_READER_CHG_FN)(LCS_SERVER *cs, GWEN_TYPE_UINT32 did, GWEN_TYPE_UINT32 rid, const char *readerType, const char *readerName, const char *readerInfo, LC_READER_STATUS newSt, const char *reason)

typedef void(* LCS_SERVER_SERVICE_CHG_FN)(LCS_SERVER *cs, GWEN_TYPE_UINT32 sid, const char *serviceType, const char *serviceName, LC_SERVICE_STATUS newSt, const char *reason)

---

Function Documentation

void LCS_Server_BeginUseReaders

(

LCS_SERVER *

cs

)

This function is used when a client sends a WaitForCard-request.

void LCS_Server_CardRemoved	(	LCS_SERVER *	cs,
		GWEN_TYPE_UINT32	rid,
		int	slotNum,
		GWEN_TYPE_UINT32	cardNum
	)

void LCS_Server_ConnectionDown	(	LCS_SERVER *	cs,
		GWEN_NETLAYER *	conn
	)

void LCS_Server_DriverChg	(	LCS_SERVER *	cs,
		GWEN_TYPE_UINT32	did,
		const char *	driverType,
		const char *	driverName,
		const char *	libraryFile,
		LC_DRIVER_STATUS	newSt,
		const char *	reason
	)

void LCS_Server_DumpState

(

const LCS_SERVER *

cs

)

void LCS_Server_EndUseReaders	(	LCS_SERVER *	cs,
		int	count
	)

int LCS_Server_Fini	(	LCS_SERVER *	cs,
		GWEN_DB_NODE *	db
	)

void LCS_Server_free

(

LCS_SERVER *

cs

)

LCDM_DEVICEMANAGER* LCS_Server_GetDeviceManager

(

const LCS_SERVER *

cs

)

GWEN_IPCMANAGER* LCS_Server_GetIpcManager

(

const LCS_SERVER *

cs

)

GWEN_IPC_REQUEST_MANAGER* LCS_Server_GetRequestManager

(

const LCS_SERVER *

cs

)

int LCS_Server_Init	(	LCS_SERVER *	cs,
		GWEN_DB_NODE *	db
	)

LCS_SERVER* LCS_Server_new

(

)

void LCS_Server_NewCard	(	LCS_SERVER *	cs,
		LCCO_CARD *	card
	)

Makes the given new card known to the system. Right after this function is called by the LCDM_DeviceManager it is free'd, so the handler in this function MUST call LCCO_Card_Attach if it wants to use this card afterwards.

void LCS_Server_ReaderChg	(	LCS_SERVER *	cs,
		GWEN_TYPE_UINT32	did,
		GWEN_TYPE_UINT32	rid,
		const char *	readerType,
		const char *	readerName,
		const char *	readerInfo,
		LC_READER_STATUS	newSt,
		const char *	reason
	)

int LCS_Server_ReplaceVar	(	const char *	path,
		const char *	var,
		const char *	value,
		GWEN_BUFFER *	nbuf
	)

int LCS_Server_SendErrorResponse	(	LCS_SERVER *	cs,
		GWEN_TYPE_UINT32	rid,
		int	code,
		const char *	text
	)

void LCS_Server_ServiceChg	(	LCS_SERVER *	cs,
		GWEN_TYPE_UINT32	sid,
		const char *	serviceType,
		const char *	serviceName,
		LC_SERVICE_STATUS	newSt,
		const char *	reason
	)

LCS_SERVER_CARDREMOVED_FN LCS_Server_SetCardRemovedFn	(	LCS_SERVER *	cs,
		LCS_SERVER_CARDREMOVED_FN	f
	)

LCS_SERVER_CONNECTION_DOWN_FN LCS_Server_SetConnectionDownFn	(	LCS_SERVER *	cs,
		LCS_SERVER_CONNECTION_DOWN_FN	f
	)

void LCS_Server_SetDeviceManager	(	LCS_SERVER *	cs,
		LCDM_DEVICEMANAGER *	dm
	)

LCS_SERVER_DRIVER_CHG_FN LCS_Server_SetDriverChgFn	(	LCS_SERVER *	cs,
		LCS_SERVER_DRIVER_CHG_FN	f
	)

LCS_SERVER_HANDLEREQUEST_FN LCS_Server_SetHandleRequestFn	(	LCS_SERVER *	cs,
		LCS_SERVER_HANDLEREQUEST_FN	f
	)

LCS_SERVER_NEWCARD_FN LCS_Server_SetNewCardFn	(	LCS_SERVER *	cs,
		LCS_SERVER_NEWCARD_FN	f
	)

LCS_SERVER_READER_CHG_FN LCS_Server_SetReaderChgFn	(	LCS_SERVER *	cs,
		LCS_SERVER_READER_CHG_FN	f
	)

LCS_SERVER_SERVICE_CHG_FN LCS_Server_SetServiceChgFn	(	LCS_SERVER *	cs,
		LCS_SERVER_SERVICE_CHG_FN	f
	)

void LCS_Server_UseConnectionFor	(	LCS_SERVER *	cs,
		GWEN_NETLAYER *	conn,
		LCS_CONNECTION_TYPE	t,
		GWEN_TYPE_UINT32	ipcId
	)

This tells the server to use this connection. Basically this just sets the connectionUp callback to call an internal server function which in turn calls LCS_Server_ConnectionDown.

int LCS_Server_Work

(

LCS_SERVER *

cs

)

Returns:

1 if something could be done

---