/* * Implement the 7816 portion of the card spec * * This work is licensed under the terms of the GNU LGPL, version 2.1 or later. * See the COPYING file in the top-level directory. */ #ifndef CARD_7816T_H #define CARD_7816T_H 1 typedef unsigned short vcard_7816_status_t; struct VCardResponseStruct { unsigned char *b_data; vcard_7816_status_t b_status; unsigned char b_sw1; unsigned char b_sw2; int b_len; int b_total_len; enum VCardResponseBufferType { VCARD_MALLOC, VCARD_MALLOC_DATA, VCARD_MALLOC_STRUCT, VCARD_STATIC } b_type; }; #define VCARD_RESPONSE_NEW_STATIC_STATUS(stat) \ static const VCardResponse VCardResponse##stat = \ {(unsigned char *)&VCardResponse##stat.b_sw1, (stat), ((stat) >> 8), \ ((stat) & 0xff), 0, 2, VCARD_STATIC}; #define VCARD_RESPONSE_NEW_STATIC_STATUS_BYTES(sw1, sw2) \ static const VCardResponse VCARDResponse##sw1 = \ {(unsigned char *)&VCardResponse##name.b_sw1, ((sw1) << 8 | (sw2)), \ (sw1), (sw2), 0, 2, VCARD_STATIC}; /* cast away the const, callers need may need to 'free' the * result, and const implies that they don't */ #define VCARD_RESPONSE_GET_STATIC(name) \ ((VCardResponse *)(&VCardResponse##name)) typedef enum { VCARD_7816_ISO, VCARD_7816_RFU, VCARD_7816_PTS, VCARD_7816_PROPRIETARY } VCardAPDUType; /* * 7816 header. All APDU's have this header. * They must be laid out in this order. */ struct VCardAPDUHeader { unsigned char ah_cla; unsigned char ah_ins; unsigned char ah_p1; unsigned char ah_p2; unsigned char ah_Le; unsigned char ah_body[1]; /* indefinite length */ }; /* * 7816 APDU structure. The raw bytes are stored in the union and can be * accessed directly through u.data (which is aliased as a_data). * * Names of the fields match the 7816 documentation. */ struct VCardAPDUStruct { int a_len; /* length of the whole buffer, including header */ int a_Lc; /* 7816 Lc (parameter length) value */ int a_Le; /* 7816 Le (expected result length) value */ unsigned char *a_body; /* pointer to the parameter */ int a_channel; /* decoded channel */ int a_secure_messaging; /* decoded secure messaging type */ int a_type; /* decoded type from cla (top nibble of class) */ VCardAPDUType a_gen_type; /* generic type (7816, PROPRIETARY, RFU, etc) */ union { struct VCardAPDUHeader *header; unsigned char *data; } u; /* give the subfields a unified look */ #define a_header u.header #define a_data u.data #define a_cla a_header->ah_cla /* class */ #define a_ins a_header->ah_ins /* instruction */ #define a_p1 a_header->ah_p1 /* parameter 1 */ #define a_p2 a_header->ah_p2 /* parameter 2 */ }; /* 7816 status codes */ #define VCARD7816_STATUS_SUCCESS 0x9000 #define VCARD7816_STATUS_WARNING 0x6200 #define VCARD7816_STATUS_WARNING_RET_CORUPT 0x6281 #define VCARD7816_STATUS_WARNING_BUF_END_BEFORE_LE 0x6282 #define VCARD7816_STATUS_WARNING_INVALID_FILE_SELECTED 0x6283 #define VCARD7816_STATUS_WARNING_FCI_FORMAT_INVALID 0x6284 #define VCARD7816_STATUS_WARNING_CHANGE 0x6300 #define VCARD7816_STATUS_WARNING_FILE_FILLED 0x6381 #define VCARD7816_STATUS_EXC_ERROR 0x6400 #define VCARD7816_STATUS_EXC_ERROR_CHANGE 0x6500 #define VCARD7816_STATUS_EXC_ERROR_MEMORY_FAILURE 0x6581 #define VCARD7816_STATUS_ERROR_WRONG_LENGTH 0x6700 #define VCARD7816_STATUS_ERROR_CLA_NOT_SUPPORTED 0x6800 #define VCARD7816_STATUS_ERROR_CHANNEL_NOT_SUPPORTED 0x6881 #define VCARD7816_STATUS_ERROR_SECURE_NOT_SUPPORTED 0x6882 #define VCARD7816_STATUS_ERROR_COMMAND_NOT_SUPPORTED 0x6900 #define VCARD7816_STATUS_ERROR_COMMAND_INCOMPATIBLE_WITH_FILE 0x6981 #define VCARD7816_STATUS_ERROR_SECURITY_NOT_SATISFIED 0x6982 #define VCARD7816_STATUS_ERROR_AUTHENTICATION_BLOCKED 0x6983 #define VCARD7816_STATUS_ERROR_DATA_INVALID 0x6984 #define VCARD7816_STATUS_ERROR_CONDITION_NOT_SATISFIED 0x6985 #define VCARD7816_STATUS_ERROR_DATA_NO_EF 0x6986 #define VCARD7816_STATUS_ERROR_SM_OBJECT_MISSING 0x6987 #define VCARD7816_STATUS_ERROR_SM_OBJECT_INCORRECT 0x6988 #define VCARD7816_STATUS_ERROR_WRONG_PARAMETERS 0x6a00 #define VCARD7816_STATUS_ERROR_WRONG_PARAMETERS_IN_DATA 0x6a80 #define VCARD7816_STATUS_ERROR_FUNCTION_NOT_SUPPORTED 0x6a81 #define VCARD7816_STATUS_ERROR_FILE_NOT_FOUND 0x6a82 #define VCARD7816_STATUS_ERROR_RECORD_NOT_FOUND 0x6a83 #define VCARD7816_STATUS_ERROR_NO_SPACE_FOR_FILE 0x6a84 #define VCARD7816_STATUS_ERROR_LC_TLV_INCONSISTENT 0x6a85 #define VCARD7816_STATUS_ERROR_P1_P2_INCORRECT 0x6a86 #define VCARD7816_STATUS_ERROR_LC_P1_P2_INCONSISTENT 0x6a87 #define VCARD7816_STATUS_ERROR_DATA_NOT_FOUND 0x6a88 #define VCARD7816_STATUS_ERROR_WRONG_PARAMETERS_2 0x6b00 #define VCARD7816_STATUS_ERROR_INS_CODE_INVALID 0x6d00 #define VCARD7816_STATUS_ERROR_CLA_INVALID 0x6e00 #define VCARD7816_STATUS_ERROR_GENERAL 0x6f00 /* 7816 sw1 codes */ #define VCARD7816_SW1_SUCCESS 0x90 #define VCARD7816_SW1_RESPONSE_BYTES 0x61 #define VCARD7816_SW1_WARNING 0x62 #define VCARD7816_SW1_WARNING_CHANGE 0x63 #define VCARD7816_SW1_EXC_ERROR 0x64 #define VCARD7816_SW1_EXC_ERROR_CHANGE 0x65 #define VCARD7816_SW1_ERROR_WRONG_LENGTH 0x67 #define VCARD7816_SW1_CLA_ERROR 0x68 #define VCARD7816_SW1_COMMAND_ERROR 0x69 #define VCARD7816_SW1_P1_P2_ERROR 0x6a #define VCARD7816_SW1_LE_ERROR 0x6c #define VCARD7816_SW1_INS_ERROR 0x6d #define VCARD7816_SW1_CLA_NOT_SUPPORTED 0x6e /* 7816 Instructions */ #define VCARD7816_INS_MANAGE_CHANNEL 0x70 #define VCARD7816_INS_EXTERNAL_AUTHENTICATE 0x82 #define VCARD7816_INS_GET_CHALLENGE 0x84 #define VCARD7816_INS_INTERNAL_AUTHENTICATE 0x88 #define VCARD7816_INS_ERASE_BINARY 0x0e #define VCARD7816_INS_READ_BINARY 0xb0 #define VCARD7816_INS_WRITE_BINARY 0xd0 #define VCARD7816_INS_UPDATE_BINARY 0xd6 #define VCARD7816_INS_READ_RECORD 0xb2 #define VCARD7816_INS_WRITE_RECORD 0xd2 #define VCARD7816_INS_UPDATE_RECORD 0xdc #define VCARD7816_INS_APPEND_RECORD 0xe2 #define VCARD7816_INS_ENVELOPE 0xc2 #define VCARD7816_INS_PUT_DATA 0xda #define VCARD7816_INS_GET_DATA 0xca #define VCARD7816_INS_SELECT_FILE 0xa4 #define VCARD7816_INS_VERIFY 0x20 #define VCARD7816_INS_GET_RESPONSE 0xc0 #endif