87 lines
		
	
	
		
			2.8 KiB
		
	
	
	
		
			C
		
	
	
	
			
		
		
	
	
			87 lines
		
	
	
		
			2.8 KiB
		
	
	
	
		
			C
		
	
	
	
| /*
 | |
|  * 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_H
 | |
| #define VCARD_H 1
 | |
| 
 | |
| #include "vcardt.h"
 | |
| 
 | |
| /*
 | |
|  * response buffer constructors and destructors.
 | |
|  *
 | |
|  * response buffers are used when we need to return more data than will fit in
 | |
|  * a normal APDU response (nominally 254 bytes).
 | |
|  */
 | |
| VCardBufferResponse *vcard_buffer_response_new(unsigned char *buffer, int size);
 | |
| void vcard_buffer_response_delete(VCardBufferResponse *buffer_response);
 | |
| 
 | |
| 
 | |
| /*
 | |
|  * clean up state on reset
 | |
|  */
 | |
| void vcard_reset(VCard *card, VCardPower power);
 | |
| 
 | |
| /*
 | |
|  * applet utilities
 | |
|  */
 | |
| /*
 | |
|  * Constructor for a VCardApplet
 | |
|  */
 | |
| VCardApplet *vcard_new_applet(VCardProcessAPDU applet_process_function,
 | |
|                               VCardResetApplet applet_reset_function,
 | |
|                               unsigned char *aid, int aid_len);
 | |
| 
 | |
| /*
 | |
|  * destructor for a VCardApplet
 | |
|  *  Can be called with a NULL applet
 | |
|  */
 | |
| void vcard_delete_applet(VCardApplet *applet);
 | |
| 
 | |
| /* accessor - set the card type specific private data */
 | |
| void vcard_set_applet_private(VCardApplet *applet, VCardAppletPrivate *_private,
 | |
|                               VCardAppletPrivateFree private_free);
 | |
| 
 | |
| /* set type of vcard */
 | |
| void vcard_set_type(VCard *card, VCardType type);
 | |
| 
 | |
| /*
 | |
|  * utilities interacting with the current applet
 | |
|  */
 | |
| /* add a new applet to a card */
 | |
| VCardStatus vcard_add_applet(VCard *card, VCardApplet *applet);
 | |
| /* find the applet on the card with the given aid */
 | |
| VCardApplet *vcard_find_applet(VCard *card, unsigned char *aid, int aid_len);
 | |
| /* set the following applet to be current on the given channel */
 | |
| void vcard_select_applet(VCard *card, int channel, VCardApplet *applet);
 | |
| /* get the card type specific private data on the given channel */
 | |
| VCardAppletPrivate *vcard_get_current_applet_private(VCard *card, int channel);
 | |
| /* fetch the applet's id */
 | |
| unsigned char *vcard_applet_get_aid(VCardApplet *applet, int *aid_len);
 | |
| 
 | |
| /* process the apdu for the current selected applet/file */
 | |
| VCardStatus vcard_process_applet_apdu(VCard *card, VCardAPDU *apdu,
 | |
|                                       VCardResponse **response);
 | |
| /*
 | |
|  * VCard utilities
 | |
|  */
 | |
| /* constructor */
 | |
| VCard *vcard_new(VCardEmul *_private, VCardEmulFree private_free);
 | |
| /* get a reference */
 | |
| VCard *vcard_reference(VCard *);
 | |
| /* destructor (reference counted) */
 | |
| void vcard_free(VCard *);
 | |
| /* get the atr from the card */
 | |
| void vcard_get_atr(VCard *card, unsigned char *atr, int *atr_len);
 | |
| void vcard_set_atr_func(VCard *card, VCardGetAtr vcard_get_atr);
 | |
| 
 | |
| /* accessor functions for the response buffer */
 | |
| VCardBufferResponse *vcard_get_buffer_response(VCard *card);
 | |
| void vcard_set_buffer_response(VCard *card, VCardBufferResponse *buffer);
 | |
| /* accessor functions for the type */
 | |
| VCardType vcard_get_type(VCard *card);
 | |
| /* get the private data */
 | |
| VCardEmul *vcard_get_private(VCard *card);
 | |
| 
 | |
| #endif
 |