hw/arm: versal: Move misplaced comment
[qemu/ar7.git] / hw / usb / ccid-card-emulated.c
blob308312455628c79a08b7df45da81baf47b98ca55
1 /*
2 * CCID Card Device. Emulated card.
4 * Copyright (c) 2011 Red Hat.
5 * Written by Alon Levy.
7 * This code is licensed under the GNU LGPL, version 2 or later.
8 */
11 * It can be used to provide access to the local hardware in a non exclusive
12 * way, or it can use certificates. It requires the usb-ccid bus.
14 * Usage 1: standard, mirror hardware reader+card:
15 * qemu .. -usb -device usb-ccid -device ccid-card-emulated
17 * Usage 2: use certificates, no hardware required
18 * one time: create the certificates:
19 * for i in 1 2 3; do
20 * certutil -d /etc/pki/nssdb -x -t "CT,CT,CT" -S -s "CN=user$i" -n user$i
21 * done
22 * qemu .. -usb -device usb-ccid \
23 * -device ccid-card-emulated,cert1=user1,cert2=user2,cert3=user3
25 * If you use a non default db for the certificates you can specify it using
26 * the db parameter.
29 #include "qemu/osdep.h"
30 #include <libcacard.h>
32 #include "qemu/thread.h"
33 #include "qemu/main-loop.h"
34 #include "qemu/module.h"
35 #include "ccid.h"
36 #include "hw/qdev-properties.h"
37 #include "qapi/error.h"
39 #define DPRINTF(card, lvl, fmt, ...) \
40 do {\
41 if (lvl <= card->debug) {\
42 printf("ccid-card-emul: %s: " fmt , __func__, ## __VA_ARGS__);\
43 } \
44 } while (0)
47 #define TYPE_EMULATED_CCID "ccid-card-emulated"
48 #define EMULATED_CCID_CARD(obj) \
49 OBJECT_CHECK(EmulatedState, (obj), TYPE_EMULATED_CCID)
51 #define BACKEND_NSS_EMULATED_NAME "nss-emulated"
52 #define BACKEND_CERTIFICATES_NAME "certificates"
54 enum {
55 BACKEND_NSS_EMULATED = 1,
56 BACKEND_CERTIFICATES
59 #define DEFAULT_BACKEND BACKEND_NSS_EMULATED
61 typedef struct EmulatedState EmulatedState;
63 enum {
64 EMUL_READER_INSERT = 0,
65 EMUL_READER_REMOVE,
66 EMUL_CARD_INSERT,
67 EMUL_CARD_REMOVE,
68 EMUL_GUEST_APDU,
69 EMUL_RESPONSE_APDU,
70 EMUL_ERROR,
73 static const char *emul_event_to_string(uint32_t emul_event)
75 switch (emul_event) {
76 case EMUL_READER_INSERT:
77 return "EMUL_READER_INSERT";
78 case EMUL_READER_REMOVE:
79 return "EMUL_READER_REMOVE";
80 case EMUL_CARD_INSERT:
81 return "EMUL_CARD_INSERT";
82 case EMUL_CARD_REMOVE:
83 return "EMUL_CARD_REMOVE";
84 case EMUL_GUEST_APDU:
85 return "EMUL_GUEST_APDU";
86 case EMUL_RESPONSE_APDU:
87 return "EMUL_RESPONSE_APDU";
88 case EMUL_ERROR:
89 return "EMUL_ERROR";
91 return "UNKNOWN";
94 typedef struct EmulEvent {
95 QSIMPLEQ_ENTRY(EmulEvent) entry;
96 union {
97 struct {
98 uint32_t type;
99 } gen;
100 struct {
101 uint32_t type;
102 uint64_t code;
103 } error;
104 struct {
105 uint32_t type;
106 uint32_t len;
107 uint8_t data[];
108 } data;
109 } p;
110 } EmulEvent;
112 #define MAX_ATR_SIZE 40
113 struct EmulatedState {
114 CCIDCardState base;
115 uint8_t debug;
116 char *backend_str;
117 uint32_t backend;
118 char *cert1;
119 char *cert2;
120 char *cert3;
121 char *db;
122 uint8_t atr[MAX_ATR_SIZE];
123 uint8_t atr_length;
124 QSIMPLEQ_HEAD(, EmulEvent) event_list;
125 QemuMutex event_list_mutex;
126 QemuThread event_thread_id;
127 VReader *reader;
128 QSIMPLEQ_HEAD(, EmulEvent) guest_apdu_list;
129 QemuMutex vreader_mutex; /* and guest_apdu_list mutex */
130 QemuMutex handle_apdu_mutex;
131 QemuCond handle_apdu_cond;
132 EventNotifier notifier;
133 int quit_apdu_thread;
134 QemuThread apdu_thread_id;
137 static void emulated_apdu_from_guest(CCIDCardState *base,
138 const uint8_t *apdu, uint32_t len)
140 EmulatedState *card = EMULATED_CCID_CARD(base);
141 EmulEvent *event = (EmulEvent *)g_malloc(sizeof(EmulEvent) + len);
143 assert(event);
144 event->p.data.type = EMUL_GUEST_APDU;
145 event->p.data.len = len;
146 memcpy(event->p.data.data, apdu, len);
147 qemu_mutex_lock(&card->vreader_mutex);
148 QSIMPLEQ_INSERT_TAIL(&card->guest_apdu_list, event, entry);
149 qemu_mutex_unlock(&card->vreader_mutex);
150 qemu_mutex_lock(&card->handle_apdu_mutex);
151 qemu_cond_signal(&card->handle_apdu_cond);
152 qemu_mutex_unlock(&card->handle_apdu_mutex);
155 static const uint8_t *emulated_get_atr(CCIDCardState *base, uint32_t *len)
157 EmulatedState *card = EMULATED_CCID_CARD(base);
159 *len = card->atr_length;
160 return card->atr;
163 static void emulated_push_event(EmulatedState *card, EmulEvent *event)
165 qemu_mutex_lock(&card->event_list_mutex);
166 QSIMPLEQ_INSERT_TAIL(&(card->event_list), event, entry);
167 qemu_mutex_unlock(&card->event_list_mutex);
168 event_notifier_set(&card->notifier);
171 static void emulated_push_type(EmulatedState *card, uint32_t type)
173 EmulEvent *event = g_new(EmulEvent, 1);
175 assert(event);
176 event->p.gen.type = type;
177 emulated_push_event(card, event);
180 static void emulated_push_error(EmulatedState *card, uint64_t code)
182 EmulEvent *event = g_new(EmulEvent, 1);
184 assert(event);
185 event->p.error.type = EMUL_ERROR;
186 event->p.error.code = code;
187 emulated_push_event(card, event);
190 static void emulated_push_data_type(EmulatedState *card, uint32_t type,
191 const uint8_t *data, uint32_t len)
193 EmulEvent *event = (EmulEvent *)g_malloc(sizeof(EmulEvent) + len);
195 assert(event);
196 event->p.data.type = type;
197 event->p.data.len = len;
198 memcpy(event->p.data.data, data, len);
199 emulated_push_event(card, event);
202 static void emulated_push_reader_insert(EmulatedState *card)
204 emulated_push_type(card, EMUL_READER_INSERT);
207 static void emulated_push_reader_remove(EmulatedState *card)
209 emulated_push_type(card, EMUL_READER_REMOVE);
212 static void emulated_push_card_insert(EmulatedState *card,
213 const uint8_t *atr, uint32_t len)
215 emulated_push_data_type(card, EMUL_CARD_INSERT, atr, len);
218 static void emulated_push_card_remove(EmulatedState *card)
220 emulated_push_type(card, EMUL_CARD_REMOVE);
223 static void emulated_push_response_apdu(EmulatedState *card,
224 const uint8_t *apdu, uint32_t len)
226 emulated_push_data_type(card, EMUL_RESPONSE_APDU, apdu, len);
229 #define APDU_BUF_SIZE 270
230 static void *handle_apdu_thread(void* arg)
232 EmulatedState *card = arg;
233 uint8_t recv_data[APDU_BUF_SIZE];
234 int recv_len;
235 VReaderStatus reader_status;
236 EmulEvent *event;
238 while (1) {
239 qemu_mutex_lock(&card->handle_apdu_mutex);
240 qemu_cond_wait(&card->handle_apdu_cond, &card->handle_apdu_mutex);
241 qemu_mutex_unlock(&card->handle_apdu_mutex);
242 if (card->quit_apdu_thread) {
243 card->quit_apdu_thread = 0; /* debugging */
244 break;
246 qemu_mutex_lock(&card->vreader_mutex);
247 while (!QSIMPLEQ_EMPTY(&card->guest_apdu_list)) {
248 event = QSIMPLEQ_FIRST(&card->guest_apdu_list);
249 assert((unsigned long)event > 1000);
250 QSIMPLEQ_REMOVE_HEAD(&card->guest_apdu_list, entry);
251 if (event->p.data.type != EMUL_GUEST_APDU) {
252 DPRINTF(card, 1, "unexpected message in handle_apdu_thread\n");
253 g_free(event);
254 continue;
256 if (card->reader == NULL) {
257 DPRINTF(card, 1, "reader is NULL\n");
258 g_free(event);
259 continue;
261 recv_len = sizeof(recv_data);
262 reader_status = vreader_xfr_bytes(card->reader,
263 event->p.data.data, event->p.data.len,
264 recv_data, &recv_len);
265 DPRINTF(card, 2, "got back apdu of length %d\n", recv_len);
266 if (reader_status == VREADER_OK) {
267 emulated_push_response_apdu(card, recv_data, recv_len);
268 } else {
269 emulated_push_error(card, reader_status);
271 g_free(event);
273 qemu_mutex_unlock(&card->vreader_mutex);
275 return NULL;
278 static void *event_thread(void *arg)
280 int atr_len = MAX_ATR_SIZE;
281 uint8_t atr[MAX_ATR_SIZE];
282 VEvent *event = NULL;
283 EmulatedState *card = arg;
285 while (1) {
286 const char *reader_name;
288 event = vevent_wait_next_vevent();
289 if (event == NULL || event->type == VEVENT_LAST) {
290 break;
292 if (event->type != VEVENT_READER_INSERT) {
293 if (card->reader == NULL && event->reader != NULL) {
294 /* Happens after device_add followed by card remove or insert.
295 * XXX: create synthetic add_reader events if vcard_emul_init
296 * already called, which happens if device_del and device_add
297 * are called */
298 card->reader = vreader_reference(event->reader);
299 } else {
300 if (event->reader != card->reader) {
301 fprintf(stderr,
302 "ERROR: wrong reader: quiting event_thread\n");
303 break;
307 switch (event->type) {
308 case VEVENT_READER_INSERT:
309 /* TODO: take a specific reader. i.e. track which reader
310 * we are seeing here, check it is the one we want (the first,
311 * or by a particular name), and ignore if we don't want it.
313 reader_name = vreader_get_name(event->reader);
314 if (card->reader != NULL) {
315 DPRINTF(card, 2, "READER INSERT - replacing %s with %s\n",
316 vreader_get_name(card->reader), reader_name);
317 qemu_mutex_lock(&card->vreader_mutex);
318 vreader_free(card->reader);
319 qemu_mutex_unlock(&card->vreader_mutex);
320 emulated_push_reader_remove(card);
322 qemu_mutex_lock(&card->vreader_mutex);
323 DPRINTF(card, 2, "READER INSERT %s\n", reader_name);
324 card->reader = vreader_reference(event->reader);
325 qemu_mutex_unlock(&card->vreader_mutex);
326 emulated_push_reader_insert(card);
327 break;
328 case VEVENT_READER_REMOVE:
329 DPRINTF(card, 2, " READER REMOVE: %s\n",
330 vreader_get_name(event->reader));
331 qemu_mutex_lock(&card->vreader_mutex);
332 vreader_free(card->reader);
333 card->reader = NULL;
334 qemu_mutex_unlock(&card->vreader_mutex);
335 emulated_push_reader_remove(card);
336 break;
337 case VEVENT_CARD_INSERT:
338 /* get the ATR (intended as a response to a power on from the
339 * reader */
340 atr_len = MAX_ATR_SIZE;
341 vreader_power_on(event->reader, atr, &atr_len);
342 card->atr_length = (uint8_t)atr_len;
343 DPRINTF(card, 2, " CARD INSERT\n");
344 emulated_push_card_insert(card, atr, atr_len);
345 break;
346 case VEVENT_CARD_REMOVE:
347 DPRINTF(card, 2, " CARD REMOVE\n");
348 emulated_push_card_remove(card);
349 break;
350 case VEVENT_LAST: /* quit */
351 vevent_delete(event);
352 return NULL;
353 break;
354 default:
355 break;
357 vevent_delete(event);
359 return NULL;
362 static void card_event_handler(EventNotifier *notifier)
364 EmulatedState *card = container_of(notifier, EmulatedState, notifier);
365 EmulEvent *event, *next;
367 event_notifier_test_and_clear(&card->notifier);
368 qemu_mutex_lock(&card->event_list_mutex);
369 QSIMPLEQ_FOREACH_SAFE(event, &card->event_list, entry, next) {
370 DPRINTF(card, 2, "event %s\n", emul_event_to_string(event->p.gen.type));
371 switch (event->p.gen.type) {
372 case EMUL_RESPONSE_APDU:
373 ccid_card_send_apdu_to_guest(&card->base, event->p.data.data,
374 event->p.data.len);
375 break;
376 case EMUL_READER_INSERT:
377 ccid_card_ccid_attach(&card->base);
378 break;
379 case EMUL_READER_REMOVE:
380 ccid_card_ccid_detach(&card->base);
381 break;
382 case EMUL_CARD_INSERT:
383 assert(event->p.data.len <= MAX_ATR_SIZE);
384 card->atr_length = event->p.data.len;
385 memcpy(card->atr, event->p.data.data, card->atr_length);
386 ccid_card_card_inserted(&card->base);
387 break;
388 case EMUL_CARD_REMOVE:
389 ccid_card_card_removed(&card->base);
390 break;
391 case EMUL_ERROR:
392 ccid_card_card_error(&card->base, event->p.error.code);
393 break;
394 default:
395 DPRINTF(card, 2, "unexpected event\n");
396 break;
398 g_free(event);
400 QSIMPLEQ_INIT(&card->event_list);
401 qemu_mutex_unlock(&card->event_list_mutex);
404 static int init_event_notifier(EmulatedState *card, Error **errp)
406 if (event_notifier_init(&card->notifier, false) < 0) {
407 error_setg(errp, "ccid-card-emul: event notifier creation failed");
408 return -1;
410 event_notifier_set_handler(&card->notifier, card_event_handler);
411 return 0;
414 static void clean_event_notifier(EmulatedState *card)
416 event_notifier_set_handler(&card->notifier, NULL);
417 event_notifier_cleanup(&card->notifier);
420 #define CERTIFICATES_DEFAULT_DB "/etc/pki/nssdb"
421 #define CERTIFICATES_ARGS_TEMPLATE\
422 "db=\"%s\" use_hw=no soft=(,Virtual Reader,CAC,,%s,%s,%s)"
424 static int wrap_vcard_emul_init(VCardEmulOptions *options)
426 static int called;
427 static int options_was_null;
429 if (called) {
430 if ((options == NULL) != options_was_null) {
431 printf("%s: warning: running emulated with certificates"
432 " and emulated side by side is not supported\n",
433 __func__);
434 return VCARD_EMUL_FAIL;
436 vcard_emul_replay_insertion_events();
437 return VCARD_EMUL_OK;
439 options_was_null = (options == NULL);
440 called = 1;
441 return vcard_emul_init(options);
444 static int emulated_initialize_vcard_from_certificates(EmulatedState *card)
446 char emul_args[200];
447 VCardEmulOptions *options = NULL;
449 snprintf(emul_args, sizeof(emul_args) - 1, CERTIFICATES_ARGS_TEMPLATE,
450 card->db ? card->db : CERTIFICATES_DEFAULT_DB,
451 card->cert1, card->cert2, card->cert3);
452 options = vcard_emul_options(emul_args);
453 if (options == NULL) {
454 printf("%s: warning: not using certificates due to"
455 " initialization error\n", __func__);
457 return wrap_vcard_emul_init(options);
460 typedef struct EnumTable {
461 const char *name;
462 uint32_t value;
463 } EnumTable;
465 static const EnumTable backend_enum_table[] = {
466 {BACKEND_NSS_EMULATED_NAME, BACKEND_NSS_EMULATED},
467 {BACKEND_CERTIFICATES_NAME, BACKEND_CERTIFICATES},
468 {NULL, 0},
471 static uint32_t parse_enumeration(char *str,
472 const EnumTable *table, uint32_t not_found_value)
474 uint32_t ret = not_found_value;
476 if (str == NULL)
477 return 0;
479 while (table->name != NULL) {
480 if (strcmp(table->name, str) == 0) {
481 ret = table->value;
482 break;
484 table++;
486 return ret;
489 static void emulated_realize(CCIDCardState *base, Error **errp)
491 EmulatedState *card = EMULATED_CCID_CARD(base);
492 VCardEmulError ret;
493 const EnumTable *ptable;
495 QSIMPLEQ_INIT(&card->event_list);
496 QSIMPLEQ_INIT(&card->guest_apdu_list);
497 qemu_mutex_init(&card->event_list_mutex);
498 qemu_mutex_init(&card->vreader_mutex);
499 qemu_mutex_init(&card->handle_apdu_mutex);
500 qemu_cond_init(&card->handle_apdu_cond);
501 card->reader = NULL;
502 card->quit_apdu_thread = 0;
503 if (init_event_notifier(card, errp) < 0) {
504 goto out1;
507 card->backend = 0;
508 if (card->backend_str) {
509 card->backend = parse_enumeration(card->backend_str,
510 backend_enum_table, 0);
513 if (card->backend == 0) {
514 error_setg(errp, "backend must be one of:");
515 for (ptable = backend_enum_table; ptable->name != NULL; ++ptable) {
516 error_append_hint(errp, "%s\n", ptable->name);
518 goto out2;
521 /* TODO: a passthru backened that works on local machine. third card type?*/
522 if (card->backend == BACKEND_CERTIFICATES) {
523 if (card->cert1 != NULL && card->cert2 != NULL && card->cert3 != NULL) {
524 ret = emulated_initialize_vcard_from_certificates(card);
525 } else {
526 error_setg(errp, "%s: you must provide all three certs for"
527 " certificates backend", TYPE_EMULATED_CCID);
528 goto out2;
530 } else {
531 if (card->backend != BACKEND_NSS_EMULATED) {
532 error_setg(errp, "%s: bad backend specified. The options are:%s"
533 " (default), %s.", TYPE_EMULATED_CCID,
534 BACKEND_NSS_EMULATED_NAME, BACKEND_CERTIFICATES_NAME);
535 goto out2;
537 if (card->cert1 != NULL || card->cert2 != NULL || card->cert3 != NULL) {
538 error_setg(errp, "%s: unexpected cert parameters to nss emulated "
539 "backend", TYPE_EMULATED_CCID);
540 goto out2;
542 /* default to mirroring the local hardware readers */
543 ret = wrap_vcard_emul_init(NULL);
545 if (ret != VCARD_EMUL_OK) {
546 error_setg(errp, "%s: failed to initialize vcard", TYPE_EMULATED_CCID);
547 goto out2;
549 qemu_thread_create(&card->event_thread_id, "ccid/event", event_thread,
550 card, QEMU_THREAD_JOINABLE);
551 qemu_thread_create(&card->apdu_thread_id, "ccid/apdu", handle_apdu_thread,
552 card, QEMU_THREAD_JOINABLE);
554 return;
556 out2:
557 clean_event_notifier(card);
558 out1:
559 qemu_cond_destroy(&card->handle_apdu_cond);
560 qemu_mutex_destroy(&card->handle_apdu_mutex);
561 qemu_mutex_destroy(&card->vreader_mutex);
562 qemu_mutex_destroy(&card->event_list_mutex);
565 static void emulated_unrealize(CCIDCardState *base, Error **errp)
567 EmulatedState *card = EMULATED_CCID_CARD(base);
568 VEvent *vevent = vevent_new(VEVENT_LAST, NULL, NULL);
570 vevent_queue_vevent(vevent); /* stop vevent thread */
571 qemu_thread_join(&card->event_thread_id);
573 card->quit_apdu_thread = 1; /* stop handle_apdu thread */
574 qemu_cond_signal(&card->handle_apdu_cond);
575 qemu_thread_join(&card->apdu_thread_id);
577 clean_event_notifier(card);
578 /* threads exited, can destroy all condvars/mutexes */
579 qemu_cond_destroy(&card->handle_apdu_cond);
580 qemu_mutex_destroy(&card->handle_apdu_mutex);
581 qemu_mutex_destroy(&card->vreader_mutex);
582 qemu_mutex_destroy(&card->event_list_mutex);
585 static Property emulated_card_properties[] = {
586 DEFINE_PROP_STRING("backend", EmulatedState, backend_str),
587 DEFINE_PROP_STRING("cert1", EmulatedState, cert1),
588 DEFINE_PROP_STRING("cert2", EmulatedState, cert2),
589 DEFINE_PROP_STRING("cert3", EmulatedState, cert3),
590 DEFINE_PROP_STRING("db", EmulatedState, db),
591 DEFINE_PROP_UINT8("debug", EmulatedState, debug, 0),
592 DEFINE_PROP_END_OF_LIST(),
595 static void emulated_class_initfn(ObjectClass *klass, void *data)
597 DeviceClass *dc = DEVICE_CLASS(klass);
598 CCIDCardClass *cc = CCID_CARD_CLASS(klass);
600 cc->realize = emulated_realize;
601 cc->unrealize = emulated_unrealize;
602 cc->get_atr = emulated_get_atr;
603 cc->apdu_from_guest = emulated_apdu_from_guest;
604 set_bit(DEVICE_CATEGORY_INPUT, dc->categories);
605 dc->desc = "emulated smartcard";
606 device_class_set_props(dc, emulated_card_properties);
609 static const TypeInfo emulated_card_info = {
610 .name = TYPE_EMULATED_CCID,
611 .parent = TYPE_CCID_CARD,
612 .instance_size = sizeof(EmulatedState),
613 .class_init = emulated_class_initfn,
616 static void ccid_card_emulated_register_types(void)
618 type_register_static(&emulated_card_info);
621 type_init(ccid_card_emulated_register_types)