Added license information
[kvmfornfv.git] / qemu / libcacard / card_7816.h
1 /*
2  * Implement the 7816 portion of the card spec
3  *
4  * This work is licensed under the terms of the GNU LGPL, version 2.1 or later.
5  * See the COPYING.LIB file in the top-level directory.
6  */
7 #ifndef CARD_7816_H
8 #define CARD_7816_H  1
9
10 #include "card_7816t.h"
11 #include "vcardt.h"
12
13 /*
14  * constructors for VCardResponse's
15  */
16 /* response from a return buffer and a status */
17 VCardResponse *vcard_response_new(VCard *card, unsigned char *buf, int len,
18                                   int Le, vcard_7816_status_t status);
19 /* response from a return buffer and status bytes */
20 VCardResponse *vcard_response_new_bytes(VCard *card, unsigned char *buf,
21                                         int len, int Le,
22                                         unsigned char sw1, unsigned char sw2);
23 /* response from just status bytes */
24 VCardResponse *vcard_response_new_status_bytes(unsigned char sw1,
25                                                unsigned char sw2);
26 /* response from just status: NOTE this cannot fail, it will always return a
27  * valid response, if it can't allocate memory, the response will be
28  * VCARD7816_STATUS_EXC_ERROR_MEMORY_FAILURE */
29 VCardResponse *vcard_make_response(vcard_7816_status_t status);
30
31 /* create a raw response (status has already been encoded */
32 VCardResponse *vcard_response_new_data(unsigned char *buf, int len);
33
34
35
36
37 /*
38  * destructor for VCardResponse.
39  *  Can be called with a NULL response
40  */
41 void vcard_response_delete(VCardResponse *response);
42
43 /*
44  * constructor for VCardAPDU
45  */
46 VCardAPDU *vcard_apdu_new(unsigned char *raw_apdu, int len,
47                           unsigned short *status);
48
49 /*
50  * destructor for VCardAPDU
51  *  Can be called with a NULL apdu
52  */
53 void vcard_apdu_delete(VCardAPDU *apdu);
54
55 /*
56  * APDU processing starts here. This routes the card processing stuff to the
57  * right location. Always returns a valid response.
58  */
59 VCardStatus vcard_process_apdu(VCard *card, VCardAPDU *apdu,
60                                VCardResponse **response);
61
62 #endif