card.h File Reference

#include <chipcard2/chipcard2.h>
#include <gwenhywfar/buffer.h>
#include <gwenhywfar/inherit.h>
#include <gwenhywfar/xml.h>
#include <gwenhywfar/list2.h>
#include <stdio.h>
#include <chipcard2-client/client/client.h>
#include <chipcard2/sharedstuff/pininfo.h>

Include dependency graph for chipcard2-client/client/card.h:

Go to the source code of this file.

Defines

Reader Flags
These flags indicate some infos about the reader a given card is in.

#define LC_CARD_READERFLAGS_KEYPAD   LC_READER_FLAGS_KEYPAD
#define LC_CARD_READERFLAGS_DISPLAY   LC_READER_FLAGS_DISPLAY
#define LC_CARD_READERFLAGS_NOINFO   LC_READER_FLAGS_NOINFO
#define LC_CARD_READERFLAGS_REMOTE   LC_READER_FLAGS_REMOTE
#define LC_CARD_READERFLAGS_AUTO   LC_READER_FLAGS_AUTO
Flags for ISO Commands
#define LC_CARD_ISO_FLAGS_EFID_MASK   0x00000001f
#define LC_CARD_ISO_FLAGS_RECSEL_MASK   0x0000000e0
#define LC_CARD_ISO_FLAGS_RECSEL_FIRST   (0 << 5)
#define LC_CARD_ISO_FLAGS_RECSEL_LAST   (1 << 5)
#define LC_CARD_ISO_FLAGS_RECSEL_NEXT   (2 << 5)
#define LC_CARD_ISO_FLAGS_RECSEL_PREV   (3 << 5)
#define LC_CARD_ISO_FLAGS_RECSEL_GIVEN   (4 << 5)

Typedefs

typedef struct LC_CARD LC_CARD
Prototypes of Virtual Functions
typedef
LC_CLIENT_RESULT(* 		LC_CARD_OPEN_FN )(LC_CARD *card)
typedef
LC_CLIENT_RESULT(* 		LC_CARD_CLOSE_FN )(LC_CARD *card)
typedef
LC_CLIENT_RESULT(* 		LC_CARD_GETPINSTATUS_FN )(LC_CARD *card, unsigned int pid, int *maxErrors, int *currentErrors)
typedef
LC_CLIENT_RESULT(* 		LC_CARD_GETINITIALPIN_FN )(LC_CARD *card, int id, unsigned char *buffer, unsigned int maxLen, unsigned int *pinLength)
typedef
LC_CLIENT_RESULT(* 		LC_CARD_ISOREADBINARY_FN )(LC_CARD *card, GWEN_TYPE_UINT32 flags, int offset, int size, GWEN_BUFFER *buf)
typedef
LC_CLIENT_RESULT(* 		LC_CARD_ISOWRITEBINARY_FN )(LC_CARD *card, GWEN_TYPE_UINT32 flags, int offset, const char *ptr, unsigned int size)
typedef
LC_CLIENT_RESULT(* 		LC_CARD_ISOUPDATEBINARY_FN )(LC_CARD *card, GWEN_TYPE_UINT32 flags, int offset, const char *ptr, unsigned int size)
typedef
LC_CLIENT_RESULT(* 		LC_CARD_ISOERASEBINARY_FN )(LC_CARD *card, GWEN_TYPE_UINT32 flags, int offset, unsigned int size)
typedef
LC_CLIENT_RESULT(* 		LC_CARD_ISOREADRECORD_FN )(LC_CARD *card, GWEN_TYPE_UINT32 flags, int recNum, GWEN_BUFFER *buf)
typedef
LC_CLIENT_RESULT(* 		LC_CARD_ISOWRITERECORD_FN )(LC_CARD *card, GWEN_TYPE_UINT32 flags, int recNum, const char *ptr, unsigned int size)
typedef
LC_CLIENT_RESULT(* 		LC_CARD_ISOAPPENDRECORD_FN )(LC_CARD *card, GWEN_TYPE_UINT32 flags, const char *ptr, unsigned int size)
typedef
LC_CLIENT_RESULT(* 		LC_CARD_ISOUPDATERECORD_FN )(LC_CARD *card, GWEN_TYPE_UINT32 flags, int recNum, const char *ptr, unsigned int size)
typedef
LC_CLIENT_RESULT(* 		LC_CARD_ISOVERIFYPIN_FN )(LC_CARD *card, GWEN_TYPE_UINT32 flags, const LC_PININFO *pi, const unsigned char *ptr, unsigned int size, int *triesLeft)
typedef
LC_CLIENT_RESULT(* 		LC_CARD_ISOMODIFYPIN_FN )(LC_CARD *card, GWEN_TYPE_UINT32 flags, const LC_PININFO *pi, const unsigned char *oldptr, unsigned int oldsize, const unsigned char *newptr, unsigned int newsize, int *triesLeft)
typedef
LC_CLIENT_RESULT(* 		LC_CARD_ISOPERFORMVERIFICATION_FN )(LC_CARD *card, GWEN_TYPE_UINT32 flags, const LC_PININFO *pi, int *triesLeft)
typedef
LC_CLIENT_RESULT(* 		LC_CARD_ISOPERFORMMODIFICATION_FN )(LC_CARD *card, GWEN_TYPE_UINT32 flags, const LC_PININFO *pi, int *triesLeft)
typedef
LC_CLIENT_RESULT(* 		LC_CARD_ISOMANAGESE_FN )(LC_CARD *card, int tmpl, int kids, int kidp, int ar)
typedef
LC_CLIENT_RESULT(* 		LC_CARD_ISOSIGN_FN )(LC_CARD *card, const char *ptr, unsigned int size, GWEN_BUFFER *sigBuf)
typedef
LC_CLIENT_RESULT(* 		LC_CARD_ISOVERIFY_FN )(LC_CARD *card, const char *dptr, unsigned int dsize, const char *sigptr, unsigned int sigsize)
typedef
LC_CLIENT_RESULT(* 		LC_CARD_ISOENCIPHER_FN )(LC_CARD *card, const char *ptr, unsigned int size, GWEN_BUFFER *codeBuf)
typedef
LC_CLIENT_RESULT(* 		LC_CARD_ISODECIPHER_FN )(LC_CARD *card, const char *ptr, unsigned int size, GWEN_BUFFER *codeBuf)

Functions

CHIPCARD_API
LC_CLIENT_RESULT 		LC_Card_Check (LC_CARD *card)
CHIPCARD_API
LC_CLIENT_RESULT 		LC_Card_Reset (LC_CARD *card)
Setters for Virtual Functions
Functions in this group set or get pointers for virtual functions and will only be used by inheriting classes.

CHIPCARD_API
LC_CARD_OPEN_FN 		LC_Card_GetOpenFn (const LC_CARD *card)
CHIPCARD_API void LC_Card_SetOpenFn (LC_CARD *card, LC_CARD_OPEN_FN fn)
CHIPCARD_API
LC_CARD_CLOSE_FN 		LC_Card_GetCloseFn (const LC_CARD *card)
CHIPCARD_API void LC_Card_SetCloseFn (LC_CARD *card, LC_CARD_CLOSE_FN fn)
CHIPCARD_API void LC_Card_SetGetInitialPinFn (LC_CARD *card, LC_CARD_GETINITIALPIN_FN fn)
CHIPCARD_API void LC_Card_SetGetPinStatusFn (LC_CARD *card, LC_CARD_GETPINSTATUS_FN fn)
CHIPCARD_API void LC_Card_SetIsoReadBinaryFn (LC_CARD *card, LC_CARD_ISOREADBINARY_FN f)
CHIPCARD_API void LC_Card_SetIsoWriteBinaryFn (LC_CARD *card, LC_CARD_ISOWRITEBINARY_FN f)
CHIPCARD_API void LC_Card_SetIsoUpdateBinaryFn (LC_CARD *card, LC_CARD_ISOUPDATEBINARY_FN f)
CHIPCARD_API void LC_Card_SetIsoEraseBinaryFn (LC_CARD *card, LC_CARD_ISOERASEBINARY_FN f)
CHIPCARD_API void LC_Card_SetIsoReadRecordFn (LC_CARD *card, LC_CARD_ISOREADRECORD_FN f)
CHIPCARD_API void LC_Card_SetIsoWriteRecordFn (LC_CARD *card, LC_CARD_ISOWRITERECORD_FN f)
CHIPCARD_API void LC_Card_SetIsoUpdateRecordFn (LC_CARD *card, LC_CARD_ISOUPDATERECORD_FN f)
CHIPCARD_API void LC_Card_SetIsoAppendRecordFn (LC_CARD *card, LC_CARD_ISOAPPENDRECORD_FN f)
CHIPCARD_API void LC_Card_SetIsoVerifyPinFn (LC_CARD *card, LC_CARD_ISOVERIFYPIN_FN f)
CHIPCARD_API void LC_Card_SetIsoModifyPinFn (LC_CARD *card, LC_CARD_ISOMODIFYPIN_FN f)
CHIPCARD_API void LC_Card_SetIsoPerformVerificationFn (LC_CARD *card, LC_CARD_ISOPERFORMVERIFICATION_FN f)
CHIPCARD_API void LC_Card_SetIsoPerformModificationFn (LC_CARD *card, LC_CARD_ISOPERFORMMODIFICATION_FN f)
CHIPCARD_API void LC_Card_SetIsoManageSeFn (LC_CARD *card, LC_CARD_ISOMANAGESE_FN f)
CHIPCARD_API void LC_Card_SetIsoSignFn (LC_CARD *card, LC_CARD_ISOSIGN_FN f)
CHIPCARD_API void LC_Card_SetIsoVerifyFn (LC_CARD *card, LC_CARD_ISOVERIFY_FN f)
CHIPCARD_API void LC_Card_SetIsoEncipherFn (LC_CARD *card, LC_CARD_ISOENCIPHER_FN f)
CHIPCARD_API void LC_Card_SetIsoDecipherFn (LC_CARD *card, LC_CARD_ISODECIPHER_FN f)
Opening, Closing, Checking, Destroying
CHIPCARD_API
LC_CLIENT_RESULT 		LC_Card_Open (LC_CARD *card)
CHIPCARD_API
LC_CLIENT_RESULT 		LC_Card_Close (LC_CARD *card)
CHIPCARD_API void LC_Card_free (LC_CARD *cd)
CHIPCARD_API void LC_Card_List2_freeAll (LC_CARD_LIST2 *l)
Informational Functions
CHIPCARD_API
GWEN_TYPE_UINT32 		LC_Card_GetCardId (const LC_CARD *cd)
CHIPCARD_API
GWEN_TYPE_UINT32 		LC_Card_GetReaderFlags (const LC_CARD *cd)
CHIPCARD_API const char * LC_Card_GetCardType (const LC_CARD *cd)
CHIPCARD_API const
GWEN_STRINGLIST * 		LC_Card_GetCardTypes (const LC_CARD *cd)
CHIPCARD_API
GWEN_BUFFER * 		LC_Card_GetAtr (const LC_CARD *cd)
CHIPCARD_API LC_CLIENT * LC_Card_GetClient (const LC_CARD *cd)
Selecting Application/Card/DF/EF
This function is most likely called by inheriting classes, not by applications.

Chip cards contain applications which provide special functionality (e.g. the GeldKarte application or an application which supports RSA encryptio etc).

Libchipcard2 uses application description files which describe what kind of data can be found on the card and how it is formatted.

One card may contain multiple applications, e.g. German HBCI cards contain the DDV application and the GeldKarte application. Therefore Libchipcard2 must be told which application is to be used in subsequent function calls.

The Libchipcard2 server additionally holds card decription files which describe what commands are available with which cards and how these commands must look like.

So the first thing an inheriting class will do is to select the proper card type and application. The class LC_DDVCard for example uses the following function: LC_Card_SelectCardAndApp(card, "ddv0", "ddv"); for DDV0 cards and LC_Card_SelectCardAndApp(card, "ddv1", "ddv"); for DDV1 cards.

As described above normally applications do not have to bother selecting a card or application because this is done by inheriting classes upon LC_Card_Open (like in the open function set by LC_DDVCard_ExtendCard).

CHIPCARD_API int LC_Card_SelectApp (LC_CARD *card, const char *appName)
CHIPCARD_API const char * LC_Card_GetSelectedApp (const LC_CARD *card)
CHIPCARD_API
LC_CLIENT_RESULT 		LC_Card_SelectCardAndApp (LC_CARD *card, const char *cardName, const char *appName)
CHIPCARD_API
LC_CLIENT_RESULT 		LC_Card_SelectMF (LC_CARD *card)
Parsing of Structures/Records
Functions of this group use data from the application description file which is selected upon LC_Card_SelectApp or LC_Card_SelectCardAndApp. This file contains information about which folders and files are available with the given card application.

CHIPCARD_API int LC_Card_GetRecordNumber (LC_CARD *card, const char *recName)
CHIPCARD_API int LC_Card_ParseRecord (LC_CARD *card, int recNum, GWEN_BUFFER *buf, GWEN_DB_NODE *dbRecord)
CHIPCARD_API int LC_Card_CreateRecord (LC_CARD *card, int recNum, GWEN_BUFFER *buf, GWEN_DB_NODE *dbRecord)
CHIPCARD_API int LC_Card_ParseData (LC_CARD *card, const char *format, GWEN_BUFFER *buf, GWEN_DB_NODE *dbData)
CHIPCARD_API int LC_Card_CreateData (LC_CARD *card, const char *format, GWEN_BUFFER *buf, GWEN_DB_NODE *dbData)
Application/DF/EF Info
CHIPCARD_API
GWEN_XMLNODE * 		LC_Card_GetAppInfo (const LC_CARD *card)
CHIPCARD_API
GWEN_XMLNODE * 		LC_Card_GetEfInfo (const LC_CARD *card)
CHIPCARD_API
GWEN_XMLNODE * 		LC_Card_GetDfInfo (const LC_CARD *card)
Pin Functions
CHIPCARD_API LC_PININFO * LC_Card_GetPinInfoById (LC_CARD *card, GWEN_TYPE_UINT32 pid)
CHIPCARD_API LC_PININFO * LC_Card_GetPinInfoByName (LC_CARD *card, const char *name)
CHIPCARD_API
LC_CLIENT_RESULT 		LC_Card_GetPinStatus (LC_CARD *card, unsigned int pid, int *maxErrors, int *currentErrors)
CHIPCARD_API
LC_CLIENT_RESULT 		LC_Card_GetInitialPin (LC_CARD *card, int id, unsigned char *buffer, unsigned int maxLen, unsigned int *pinLength)
CHIPCARD_API
LC_CLIENT_RESULT 		LC_Card_IsoVerifyPin (LC_CARD *card, GWEN_TYPE_UINT32 flags, const LC_PININFO *pi, const unsigned char *ptr, unsigned int size, int *triesLeft)
CHIPCARD_API
LC_CLIENT_RESULT 		LC_Card_IsoModifyPin (LC_CARD *card, GWEN_TYPE_UINT32 flags, const LC_PININFO *pi, const unsigned char *oldptr, unsigned int oldsize, const unsigned char *newptr, unsigned int newsize, int *triesLeft)
CHIPCARD_API
LC_CLIENT_RESULT 		LC_Card_IsoPerformVerification (LC_CARD *card, GWEN_TYPE_UINT32 flags, const LC_PININFO *pi, int *triesLeft)
CHIPCARD_API
LC_CLIENT_RESULT 		LC_Card_IsoPerformModification (LC_CARD *card, GWEN_TYPE_UINT32 flags, const LC_PININFO *pi, int *triesLeft)
Reading and Writing Data
CHIPCARD_API
LC_CLIENT_RESULT 		LC_Card_IsoReadBinary (LC_CARD *card, GWEN_TYPE_UINT32 flags, int offset, int size, GWEN_BUFFER *buf)
CHIPCARD_API
LC_CLIENT_RESULT 		LC_Card_IsoWriteBinary (LC_CARD *card, GWEN_TYPE_UINT32 flags, int offset, const char *ptr, unsigned int size)
CHIPCARD_API
LC_CLIENT_RESULT 		LC_Card_IsoUpdateBinary (LC_CARD *card, GWEN_TYPE_UINT32 flags, int offset, const char *ptr, unsigned int size)
CHIPCARD_API
LC_CLIENT_RESULT 		LC_Card_IsoEraseBinary (LC_CARD *card, GWEN_TYPE_UINT32 flags, int offset, unsigned int size)
Reading and Writing Records
CHIPCARD_API
LC_CLIENT_RESULT 		LC_Card_IsoReadRecord (LC_CARD *card, GWEN_TYPE_UINT32 flags, int recNum, GWEN_BUFFER *buf)
CHIPCARD_API
LC_CLIENT_RESULT 		LC_Card_IsoWriteRecord (LC_CARD *card, GWEN_TYPE_UINT32 flags, int recNum, const char *ptr, unsigned int size)
CHIPCARD_API
LC_CLIENT_RESULT 		LC_Card_IsoAppendRecord (LC_CARD *card, GWEN_TYPE_UINT32 flags, const char *ptr, unsigned int size)
CHIPCARD_API
LC_CLIENT_RESULT 		LC_Card_IsoUpdateRecord (LC_CARD *card, GWEN_TYPE_UINT32 flags, int recNum, const char *ptr, unsigned int size)
Crypto Functions
CHIPCARD_API
LC_CLIENT_RESULT 		LC_Card_IsoManageSe (LC_CARD *card, int tmpl, int kids, int kidp, int ar)
CHIPCARD_API
LC_CLIENT_RESULT 		LC_Card_IsoEncipher (LC_CARD *card, const char *ptr, unsigned int size, GWEN_BUFFER *codeBuf)
CHIPCARD_API
LC_CLIENT_RESULT 		LC_Card_IsoDecipher (LC_CARD *card, const char *ptr, unsigned int size, GWEN_BUFFER *plainBuf)
CHIPCARD_API
LC_CLIENT_RESULT 		LC_Card_IsoSign (LC_CARD *card, const char *ptr, unsigned int size, GWEN_BUFFER *sigBuf)
CHIPCARD_API
LC_CLIENT_RESULT 		LC_Card_IsoVerify (LC_CARD *card, const char *dptr, unsigned int dsize, const char *sigptr, unsigned int sigsize)
Last Result
These functions return the result of the last command executed via LC_Card_ExecCommand (nearly all functions internally call that one)

CHIPCARD_API int LC_Card_GetLastSW1 (const LC_CARD *card)
CHIPCARD_API int LC_Card_GetLastSW2 (const LC_CARD *card)
CHIPCARD_API const char * LC_Card_GetLastResult (const LC_CARD *card)
CHIPCARD_API const char * LC_Card_GetLastText (const LC_CARD *card)
CHIPCARD_API void LC_Card_CreateResultString (const LC_CARD *card, const char *lastCommand, LC_CLIENT_RESULT res, GWEN_BUFFER *buf)
Command Execution
CHIPCARD_API
LC_CLIENT_RESULT 		LC_Card_ExecAPDU (LC_CARD *card, const char *apdu, unsigned int len, GWEN_BUFFER *rbuf, LC_CLIENT_CMDTARGET t, int timeout)
CHIPCARD_API
LC_CLIENT_RESULT 		LC_Card_ExecCommand (LC_CARD *card, GWEN_DB_NODE *dbReq, GWEN_DB_NODE *dbResp, int timeout)
Debugging Functions
CHIPCARD_API void LC_Card_Dump (const LC_CARD *cd, FILE *f, int indent)
Deprecated Functions
CHIPCARD_API
CHIPCARD_DEPRECATED
LC_CLIENT_RESULT 		LC_Card_ReadBinary (LC_CARD *card, int offset, int size, GWEN_BUFFER *buf)
CHIPCARD_API
CHIPCARD_DEPRECATED
LC_CLIENT_RESULT 		LC_Card_WriteBinary (LC_CARD *card, int offset, GWEN_BUFFER *buf)
CHIPCARD_API
CHIPCARD_DEPRECATED
LC_CLIENT_RESULT 		LC_Card_WriteBinary2 (LC_CARD *card, int offset, const char *ptr, unsigned int size)
CHIPCARD_API
CHIPCARD_DEPRECATED
LC_CLIENT_RESULT 		LC_Card_GetDriverVar (LC_CARD *card, const char *varName, GWEN_BUFFER *vbuf)

Function Documentation

CHIPCARD_API int LC_Card_CreateData ( LC_CARD *  card,
const char *  format,
GWEN_BUFFER *  buf,
GWEN_DB_NODE *  dbData 
)

This function creates data for the given according to the card applications format identiefied by name and stores the resulting data in the given buffer.

Parameters:
card card object
format name of the format
buf destination buffer for the resulting data
dbData GWEN_DB containing the data

CHIPCARD_API int LC_Card_CreateRecord ( LC_CARD *  card,
int  recNum,
GWEN_BUFFER *  buf,
GWEN_DB_NODE *  dbRecord 
)

This function creates data for the given record of the currently selected EF (see LC_ProcessorCard_SelectEF) and stores the resulting data in the given buffer.

CHIPCARD_API void LC_Card_CreateResultString ( const LC_CARD *  card,
const char *  lastCommand,
LC_CLIENT_RESULT  res,
GWEN_BUFFER *  buf 
)

CHIPCARD_API void LC_Card_Dump ( const LC_CARD *  cd,
FILE *  f,
int  indent 
)

CHIPCARD_API LC_CLIENT_RESULT LC_Card_ExecAPDU ( LC_CARD *  card,
const char *  apdu,
unsigned int  len,
GWEN_BUFFER *  rbuf,
LC_CLIENT_CMDTARGET  t,
int  timeout 
)

CHIPCARD_API LC_CLIENT_RESULT LC_Card_ExecCommand ( LC_CARD *  card,
GWEN_DB_NODE *  dbReq,
GWEN_DB_NODE *  dbResp,
int  timeout 
)

CHIPCARD_API GWEN_XMLNODE* LC_Card_GetAppInfo ( const LC_CARD *  card  ) 

Returns a copy of the XML node describing the currently selected card application (see LC_Card_SelectApp) The caller becomes the owner of the node returned (if any).

Returns:
XML node (or 0 if no application is selected).
Parameters:
card card object

CHIPCARD_API GWEN_BUFFER* LC_Card_GetAtr ( const LC_CARD *  cd  ) 

Returns the Answer To Reset string returned by the card upon power up. These bytes indicate some properties of the card (e.g. card type, manufacturer, memory size etc). This function returns a pointer to the internally stored ATR. The card object still remains the owner of the object returned (if any) so you must neither manipulate nor free it.

CHIPCARD_API GWEN_TYPE_UINT32 LC_Card_GetCardId ( const LC_CARD *  cd  ) 

The chipcard2 server identifies cards by ids which are unique in the server environment. No two cards can have the same id.

CHIPCARD_API const char* LC_Card_GetCardType ( const LC_CARD *  cd  ) 

Returns the type of the given card. Possible values are "MEMORY" and "PROCESSOR".

CHIPCARD_API const GWEN_STRINGLIST* LC_Card_GetCardTypes ( const LC_CARD *  cd  ) 

Returns a stringlist containing all types which match the ATR string of the given card. Possibly contents are "ddv0", "ddv1", "geldkarte" etc.

CHIPCARD_API LC_CLIENT* LC_Card_GetClient ( const LC_CARD *  cd  ) 

Returns the pointer to the client object this card belongs to.

CHIPCARD_API GWEN_XMLNODE* LC_Card_GetDfInfo ( const LC_CARD *  card  ) 

Returns a copy of the XML node describing the currently selected DF (see LC_ProcessorCard_SelectDF). The caller becomes the owner of the node returned (if any).

Parameters:
card card object

CHIPCARD_API CHIPCARD_DEPRECATED LC_CLIENT_RESULT LC_Card_GetDriverVar ( LC_CARD *  card,
const char *  varName,
GWEN_BUFFER *  vbuf 
)

Deprecated:

CHIPCARD_API GWEN_XMLNODE* LC_Card_GetEfInfo ( const LC_CARD *  card  ) 

Returns a copy of the XML node describing the currently selected EF (see LC_ProcessorCard_SelectEF). The caller becomes the owner of the node returned (if any).

Parameters:
card card object

CHIPCARD_API LC_CLIENT_RESULT LC_Card_GetInitialPin ( LC_CARD *  card,
int  id,
unsigned char *  buffer,
unsigned int  maxLen,
unsigned int *  pinLength 
)

CHIPCARD_API const char* LC_Card_GetLastResult ( const LC_CARD *  card  ) 

CHIPCARD_API int LC_Card_GetLastSW1 ( const LC_CARD *  card  ) 

CHIPCARD_API int LC_Card_GetLastSW2 ( const LC_CARD *  card  ) 

CHIPCARD_API const char* LC_Card_GetLastText ( const LC_CARD *  card  ) 

CHIPCARD_API LC_PININFO* LC_Card_GetPinInfoById ( LC_CARD *  card,
GWEN_TYPE_UINT32  pid 
)

Returns a pininfo object of the pin given by its id. The caller becomes the owner of the object returned (if any) and must call LC_PinInfo_free on it to avoid memory leaks.

CHIPCARD_API LC_PININFO* LC_Card_GetPinInfoByName ( LC_CARD *  card,
const char *  name 
)

Returns a pininfo object of the pin given by its name. The caller becomes the owner of the object returned (if any) and must call LC_PinInfo_free on it to avoid memory leaks. Standard names are "ch_pin" for the cardholder pin and "eg_pin" for the device pin (needed by STARCOS cards to modify security data on a card).

CHIPCARD_API LC_CLIENT_RESULT LC_Card_GetPinStatus ( LC_CARD *  card,
unsigned int  pid,
int *  maxErrors,
int *  currentErrors 
)

CHIPCARD_API GWEN_TYPE_UINT32 LC_Card_GetReaderFlags ( const LC_CARD *  cd  ) 

Returns the reader flags of the reader the given card is in (see LC_CARD_READERFLAGS_KEYPAD and others).

CHIPCARD_API int LC_Card_GetRecordNumber ( LC_CARD *  card,
const char *  recName 
)

The application description file allows to assign names to records of files on the card. This function returns the number of the record of the currently selected EF (see LC_ProcessorCard_SelectEF) identified by the given record name.

CHIPCARD_API const char* LC_Card_GetSelectedApp ( const LC_CARD *  card  ) 

Return the name of the currently selected application (if any).

Parameters:
card card object

CHIPCARD_API LC_CLIENT_RESULT LC_Card_IsoAppendRecord ( LC_CARD *  card,
GWEN_TYPE_UINT32  flags,
const char *  ptr,
unsigned int  size 
)

CHIPCARD_API LC_CLIENT_RESULT LC_Card_IsoDecipher ( LC_CARD *  card,
const char *  ptr,
unsigned int  size,
GWEN_BUFFER *  plainBuf 
)

CHIPCARD_API LC_CLIENT_RESULT LC_Card_IsoEncipher ( LC_CARD *  card,
const char *  ptr,
unsigned int  size,
GWEN_BUFFER *  codeBuf 
)

CHIPCARD_API LC_CLIENT_RESULT LC_Card_IsoEraseBinary ( LC_CARD *  card,
GWEN_TYPE_UINT32  flags,
int  offset,
unsigned int  size 
)

CHIPCARD_API LC_CLIENT_RESULT LC_Card_IsoManageSe ( LC_CARD *  card,
int  tmpl,
int  kids,
int  kidp,
int  ar 
)

CHIPCARD_API LC_CLIENT_RESULT LC_Card_IsoModifyPin ( LC_CARD *  card,
GWEN_TYPE_UINT32  flags,
const LC_PININFO *  pi,
const unsigned char *  oldptr,
unsigned int  oldsize,
const unsigned char *  newptr,
unsigned int  newsize,
int *  triesLeft 
)

CHIPCARD_API LC_CLIENT_RESULT LC_Card_IsoPerformModification ( LC_CARD *  card,
GWEN_TYPE_UINT32  flags,
const LC_PININFO *  pi,
int *  triesLeft 
)

CHIPCARD_API LC_CLIENT_RESULT LC_Card_IsoPerformVerification ( LC_CARD *  card,
GWEN_TYPE_UINT32  flags,
const LC_PININFO *  pi,
int *  triesLeft 
)

CHIPCARD_API LC_CLIENT_RESULT LC_Card_IsoReadBinary ( LC_CARD *  card,
GWEN_TYPE_UINT32  flags,
int  offset,
int  size,
GWEN_BUFFER *  buf 
)

CHIPCARD_API LC_CLIENT_RESULT LC_Card_IsoReadRecord ( LC_CARD *  card,
GWEN_TYPE_UINT32  flags,
int  recNum,
GWEN_BUFFER *  buf 
)

CHIPCARD_API LC_CLIENT_RESULT LC_Card_IsoSign ( LC_CARD *  card,
const char *  ptr,
unsigned int  size,
GWEN_BUFFER *  sigBuf 
)

CHIPCARD_API LC_CLIENT_RESULT LC_Card_IsoUpdateBinary ( LC_CARD *  card,
GWEN_TYPE_UINT32  flags,
int  offset,
const char *  ptr,
unsigned int  size 
)

CHIPCARD_API LC_CLIENT_RESULT LC_Card_IsoUpdateRecord ( LC_CARD *  card,
GWEN_TYPE_UINT32  flags,
int  recNum,
const char *  ptr,
unsigned int  size 
)

CHIPCARD_API LC_CLIENT_RESULT LC_Card_IsoVerify ( LC_CARD *  card,
const char *  dptr,
unsigned int  dsize,
const char *  sigptr,
unsigned int  sigsize 
)

CHIPCARD_API LC_CLIENT_RESULT LC_Card_IsoVerifyPin ( LC_CARD *  card,
GWEN_TYPE_UINT32  flags,
const LC_PININFO *  pi,
const unsigned char *  ptr,
unsigned int  size,
int *  triesLeft 
)

CHIPCARD_API LC_CLIENT_RESULT LC_Card_IsoWriteBinary ( LC_CARD *  card,
GWEN_TYPE_UINT32  flags,
int  offset,
const char *  ptr,
unsigned int  size 
)

CHIPCARD_API LC_CLIENT_RESULT LC_Card_IsoWriteRecord ( LC_CARD *  card,
GWEN_TYPE_UINT32  flags,
int  recNum,
const char *  ptr,
unsigned int  size 
)

CHIPCARD_API int LC_Card_ParseData ( LC_CARD *  card,
const char *  format,
GWEN_BUFFER *  buf,
GWEN_DB_NODE *  dbData 
)

The application description file may contain some descriptions of formats used with the acard application. These formats are identified using names. This function parses the given data and stores the parsed data in the given DB.

Parameters:
card card object
format name of the format
buf buffer containing data to parse
dbData GWEN_DB to receive the parsed data

CHIPCARD_API int LC_Card_ParseRecord ( LC_CARD *  card,
int  recNum,
GWEN_BUFFER *  buf,
GWEN_DB_NODE *  dbRecord 
)

This function parses the given record of the currently selected EF (see LC_ProcessorCard_SelectEF) and stores the parsed data in the given DB.

CHIPCARD_API CHIPCARD_DEPRECATED LC_CLIENT_RESULT LC_Card_ReadBinary ( LC_CARD *  card,
int  offset,
int  size,
GWEN_BUFFER *  buf 
)

Deprecated:
use LC_Card_IsoReadBinary(card, 0, offset, size, buf) instead

CHIPCARD_API int LC_Card_SelectApp ( LC_CARD *  card,
const char *  appName 
)

Select the application. This only effects the client part of Libchipcard2.

Parameters:
card card object
appName application name (e.g. "ddv", "kvk")

CHIPCARD_API LC_CLIENT_RESULT LC_Card_SelectCardAndApp ( LC_CARD *  card,
const char *  cardName,
const char *  appName 
)

Select the card type and application for the given card object.

Parameters:
card card object
cardName card type name (e.g. "ddv1")
appName application name (e.g. "ddv", "kvk")

CHIPCARD_API LC_CLIENT_RESULT LC_Card_SelectMF ( LC_CARD *  card  ) 

Select the Master File of the card. The MAster File is similiar to the root of a file system. For processor cards there are also some functions which select individual folders (DF) or files (EF) on a chip card (see LC_ProcessorCard_SelectDF and LC_ProcessorCard_SelectEF)

Parameters:
card card object

CHIPCARD_API CHIPCARD_DEPRECATED LC_CLIENT_RESULT LC_Card_WriteBinary ( LC_CARD *  card,
int  offset,
GWEN_BUFFER *  buf 
)

Deprecated:

CHIPCARD_API CHIPCARD_DEPRECATED LC_CLIENT_RESULT LC_Card_WriteBinary2 ( LC_CARD *  card,
int  offset,
const char *  ptr,
unsigned int  size 
)

Deprecated:

Generated on Sat Sep 22 04:38:38 2007 for libchipcard2 by  doxygen 1.5.3