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
66 lines
2.1 KiB
C
66 lines
2.1 KiB
C
/*
|
|
* This is the actual card emulator.
|
|
*
|
|
* These functions can be implemented in different ways on different platforms
|
|
* using the underlying system primitives. For Linux it uses NSS, though direct
|
|
* to PKCS #11, openssl+pkcs11, or even gnu crypto libraries+pkcs #11 could be
|
|
* used. On Windows CAPI could be used.
|
|
*
|
|
* 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_EMUL_H
|
|
#define VCARD_EMUL_H 1
|
|
|
|
#include "card_7816t.h"
|
|
#include "vcard.h"
|
|
#include "vcard_emul_type.h"
|
|
|
|
/*
|
|
* types
|
|
*/
|
|
typedef enum {
|
|
VCARD_EMUL_OK = 0,
|
|
VCARD_EMUL_FAIL,
|
|
/* return values by vcard_emul_init */
|
|
VCARD_EMUL_INIT_ALREADY_INITED,
|
|
} VCardEmulError;
|
|
|
|
/* options are emul specific. call card_emul_parse_args to change a string
|
|
* To an options struct */
|
|
typedef struct VCardEmulOptionsStruct VCardEmulOptions;
|
|
|
|
/*
|
|
* Login functions
|
|
*/
|
|
/* return the number of login attempts still possible on the card. if unknown,
|
|
* return -1 */
|
|
int vcard_emul_get_login_count(VCard *card);
|
|
/* login into the card, return the 7816 status word (sw2 || sw1) */
|
|
vcard_7816_status_t vcard_emul_login(VCard *card, unsigned char *pin,
|
|
int pin_len);
|
|
|
|
/*
|
|
* key functions
|
|
*/
|
|
/* delete a key */
|
|
void vcard_emul_delete_key(VCardKey *key);
|
|
/* RSA sign/decrypt with the key, signature happens 'in place' */
|
|
vcard_7816_status_t vcard_emul_rsa_op(VCard *card, VCardKey *key,
|
|
unsigned char *buffer, int buffer_size);
|
|
|
|
void vcard_emul_reset(VCard *card, VCardPower power);
|
|
void vcard_emul_get_atr(VCard *card, unsigned char *atr, int *atr_len);
|
|
|
|
/* Re-insert of a card that has been removed by force removal */
|
|
VCardEmulError vcard_emul_force_card_insert(VReader *vreader);
|
|
/* Force a card removal even if the card is not physically removed */
|
|
VCardEmulError vcard_emul_force_card_remove(VReader *vreader);
|
|
|
|
VCardEmulOptions *vcard_emul_options(const char *args);
|
|
VCardEmulError vcard_emul_init(const VCardEmulOptions *options);
|
|
void vcard_emul_replay_insertion_events(void);
|
|
void vcard_emul_usage(void);
|
|
#endif
|