111a38b018
libcacard emulates a Common Access Card (CAC) which is a standard
for smartcards. It is used by the emulated ccid card introduced in
a following patch. Docs are available in docs/libcacard.txt
Signed-off-by: Alon Levy <alevy@redhat.com>
---
changes from v24->v25:
* Fix out of tree builds.
* Fix build with linux-user targets.
changes from v23->v24: (Jes Sorensen review 2)
* Makefile.target: use obj-$(CONFIG_*) +=
* remove unrequired includes, include qemu-common before qemu-thread
* required adding #define NO_NSPR_10_SUPPORT (harmless)
changes from v22->v23:
* configure fixes: (reported by Stefan Hajnoczi)
* test a = b, not a == b (second isn't portable)
* quote $source_path in case it contains spaces
- this doesn't really help since there are many other places
that need similar fixes, not introduced by this patch.
changes from v21->v22:
* fix configure to not link libcacard if nss not found
(reported by Stefan Hajnoczi)
* fix vscclient linkage with simpletrace backend
(reported by Stefan Hajnoczi)
* card_7816.c: add missing break in ERROR_DATA_NOT_FOUND
(reported by William van de Velde)
changes from v20->v21: (Jes Sorensen review)
* use qemu infrastructure: qemu-thread, qemu-common (qemu_malloc
and qemu_free), error_report
* assert instead of ASSERT
* cosmetic fixes
* use strpbrk and isspace
* add --disable-nss --enable-nss here, instead of in the final patch.
* split vscclient, passthru and docs to following patches.
changes from v19->v20:
* checkpatch.pl
changes from v15->v16:
Build:
* don't erase self with distclean
* fix make clean after make distclean
* Makefile: make vscclient link quiet
Behavioral:
* vcard_emul_nss: load coolkey in more situations
* vscclient:
* use hton,ntoh
* send init on connect, only start vevent thread on response
* read payload after header check, before type switch
* remove Reconnect
* update for vscard_common changes, empty Flush implementation
Style/Whitespace:
* fix wrong variable usage
* remove unused variable
* use only C style comments
* add copyright header
* fix tabulation
Signed-off-by: Alon Levy <alevy@redhat.com>
libcacard: fix out of tree builds
87 lines
2.8 KiB
C
87 lines
2.8 KiB
C
/*
|
|
* This work is licensed under the terms of the GNU LGPL, version 2.1 or later.
|
|
* See the COPYING.LIB file in the top-level directory.
|
|
*/
|
|
#ifndef VCARD_H
|
|
#define VCARD_H 1
|
|
|
|
#include "vcardt.h"
|
|
|
|
/*
|
|
* response buffer constructors and destructors.
|
|
*
|
|
* response buffers are used when we need to return more data than will fit in
|
|
* a normal APDU response (nominally 254 bytes).
|
|
*/
|
|
VCardBufferResponse *vcard_buffer_response_new(unsigned char *buffer, int size);
|
|
void vcard_buffer_response_delete(VCardBufferResponse *buffer_response);
|
|
|
|
|
|
/*
|
|
* clean up state on reset
|
|
*/
|
|
void vcard_reset(VCard *card, VCardPower power);
|
|
|
|
/*
|
|
* applet utilities
|
|
*/
|
|
/*
|
|
* Constructor for a VCardApplet
|
|
*/
|
|
VCardApplet *vcard_new_applet(VCardProcessAPDU applet_process_function,
|
|
VCardResetApplet applet_reset_function,
|
|
unsigned char *aid, int aid_len);
|
|
|
|
/*
|
|
* destructor for a VCardApplet
|
|
* Can be called with a NULL applet
|
|
*/
|
|
void vcard_delete_applet(VCardApplet *applet);
|
|
|
|
/* accessor - set the card type specific private data */
|
|
void vcard_set_applet_private(VCardApplet *applet, VCardAppletPrivate *_private,
|
|
VCardAppletPrivateFree private_free);
|
|
|
|
/* set type of vcard */
|
|
void vcard_set_type(VCard *card, VCardType type);
|
|
|
|
/*
|
|
* utilities interacting with the current applet
|
|
*/
|
|
/* add a new applet to a card */
|
|
VCardStatus vcard_add_applet(VCard *card, VCardApplet *applet);
|
|
/* find the applet on the card with the given aid */
|
|
VCardApplet *vcard_find_applet(VCard *card, unsigned char *aid, int aid_len);
|
|
/* set the following applet to be current on the given channel */
|
|
void vcard_select_applet(VCard *card, int channel, VCardApplet *applet);
|
|
/* get the card type specific private data on the given channel */
|
|
VCardAppletPrivate *vcard_get_current_applet_private(VCard *card, int channel);
|
|
/* fetch the applet's id */
|
|
unsigned char *vcard_applet_get_aid(VCardApplet *applet, int *aid_len);
|
|
|
|
/* process the apdu for the current selected applet/file */
|
|
VCardStatus vcard_process_applet_apdu(VCard *card, VCardAPDU *apdu,
|
|
VCardResponse **response);
|
|
/*
|
|
* VCard utilities
|
|
*/
|
|
/* constructor */
|
|
VCard *vcard_new(VCardEmul *_private, VCardEmulFree private_free);
|
|
/* get a reference */
|
|
VCard *vcard_reference(VCard *);
|
|
/* destructor (reference counted) */
|
|
void vcard_free(VCard *);
|
|
/* get the atr from the card */
|
|
void vcard_get_atr(VCard *card, unsigned char *atr, int *atr_len);
|
|
void vcard_set_atr_func(VCard *card, VCardGetAtr vcard_get_atr);
|
|
|
|
/* accessor functions for the response buffer */
|
|
VCardBufferResponse *vcard_get_buffer_response(VCard *card);
|
|
void vcard_set_buffer_response(VCard *card, VCardBufferResponse *buffer);
|
|
/* accessor functions for the type */
|
|
VCardType vcard_get_type(VCard *card);
|
|
/* get the private data */
|
|
VCardEmul *vcard_get_private(VCard *card);
|
|
|
|
#endif
|