libcacard/card_7816t.h - qemu - Git at Google

 /*
  * 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.LIB 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
	/*
	* 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.LIB 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