/****************************/
/* THIS IS OPEN SOURCE CODE */
/****************************/

/* 
* File:    papivi.h
* CVS:     $Id$
* Author:  dan terpstra
*          terpstra@cs.utk.edu
* Mods:    your name here
*          yourname@cs.esu.edu
*
* Include this file INSTEAD OF "papi.h" in your application code
* to provide semitransparent version independent PAPI support.
* Follow the rules described below and elsewhere to facilitate
* this support.
*
*/

#ifndef _PAPIVI
#define _PAPIVI

#include "papi.h"

/***************************************************************************
* If PAPI_VERSION is not defined, then papi.h is for PAPI 2.
* The preprocessor block below contains the definitions, data structures,
* macros and code needed to emulate much of the PAPI 3 interface in code
* linking to the PAPI 2 library.
****************************************************************************/
#ifndef PAPI_VERSION


#define PAPI_VERSION_NUMBER(maj,min,rev) (((maj)<<16) | ((min)<<8) | (rev))
#define PAPI_VERSION_MAJOR(x)   	(((x)>>16)    & 0xffff)
#define PAPI_VERSION_MINOR(x)		(((x)>>8)     & 0xff)
#define PAPI_VERSION_REVISION(x)	((x)          & 0xff)

/* This is the PAPI version on which we are running */
#define PAPI_VERSION  			PAPI_VERSION_NUMBER(2,3,4)

/* This is the PAPI 3 version with which we are compatible */
#define PAPI_VI_VERSION  			PAPI_VERSION_NUMBER(3,0,6)

/* PAPI 3 has an error code not defined for PAPI 2 */
#define PAPI_EPERM   PAPI_EMISC	/* You lack the necessary permissions */

/*
* These are defined in papi_internal.h for PAPI 2.
* They need to be exposed for version independent PAPI code to work.
*/
//#define PRESET_MASK     0x80000000
#define PAPI_PRESET_MASK 0x80000000
//#define PRESET_AND_MASK 0x7FFFFFFF
#define PAPI_PRESET_AND_MASK 0x7FFFFFFF
#define PAPI_NATIVE_MASK 0x40000000
#define PAPI_NATIVE_AND_MASK 0x3FFFFFFF

/*
* Some PAPI 3 definitions for PAPI_{set,get}_opt() map
* onto single definitions in PAPI 2. The new definitions
* (shown below) should be used to guarantee PAPI 3 compatibility.
*/
#define PAPI_CLOCKRATE     PAPI_GET_CLOCKRATE
#define PAPI_MAX_HWCTRS    PAPI_GET_MAX_HWCTRS
#define PAPI_HWINFO        PAPI_GET_HWINFO
#define PAPI_EXEINFO       PAPI_GET_EXEINFO
#define PAPI_MAX_CPUS      PAPI_GET_MAX_CPUS
#define PAPI_CPUS          PAPI_GET_CPUS
#define PAPI_THREADS       PAPI_GET_THREADS

/*
* PAPI 2 defined only one string length.
* PAPI 3 defines three. This insures limited compatibility.
*/
#define PAPI_MIN_STR_LEN   PAPI_MAX_STR_LEN
#define PAPI_HUGE_STR_LEN  PAPI_MAX_STR_LEN

/*
* PAPI 2 always profiles into 16-bit buckets.
* PAPI 3 supports multiple bucket sizes.
* Exercise caution if these defines appear in your code.
* There is a potential for data overflow in PAPI 2.
*/
#define PAPI_PROFIL_BUCKET_16 0
#define PAPI_PROFIL_BUCKET_32 0
#define PAPI_PROFIL_BUCKET_64 0

/*
* PAPI 3 defines a new eventcode that can often be emulated
* successfully on PAPI 2. PAPI 3 also deprecates two eventcodes
* found in PAPI 2:
* PAPI_IPS   (instructions per second)
* PAPI_FLOPS (floating point instructions per second)
* Don't use these eventcodes in version independent code
*/
#define PAPI_FP_OPS PAPI_FP_INS

/*
* Two new data structures are introduced in PAPI 3 that are 
* required to support the functionality of:
* PAPI_get_event_info() and
* PAPI_get_executable_info()
* These structures are reproduced below.
* They MUST stay synchronized with their counterparts in papi.h
*/
#define PAPI_MAX_INFO_TERMS 8
typedef struct event_info
{
	unsigned int event_code;
	unsigned int count;
	char symbol[PAPI_MAX_STR_LEN + 3];
	char short_descr[PAPI_MIN_STR_LEN];
	char long_descr[PAPI_HUGE_STR_LEN];
	char derived[PAPI_MIN_STR_LEN];
	char postfix[PAPI_MIN_STR_LEN];
	unsigned int code[PAPI_MAX_INFO_TERMS];
	char name[PAPI_MAX_INFO_TERMS]
		[PAPI_MIN_STR_LEN];
	char note[PAPI_HUGE_STR_LEN];
} PAPI_event_info_t;

/* Possible values for the 'modifier' parameter of the PAPI_enum_event call.
   This enumeration is new in PAPI 3. It will act as a nop in PAPI 2, but
   must be defined for code compatibility.
*/
enum
{
	PAPI_ENUM_ALL = 0,				   /* Always enumerate all events */
	PAPI_PRESET_ENUM_AVAIL,	 /* Enumerate events that exist here */

	/* PAPI PRESET section */
	PAPI_PRESET_ENUM_INS,	 /* Instruction related preset events */
	PAPI_PRESET_ENUM_BR,	 /* branch related preset events */
	PAPI_PRESET_ENUM_MEM,	 /* memory related preset events */
	PAPI_PRESET_ENUM_TLB,	 /* Translation Lookaside Buffer events */
	PAPI_PRESET_ENUM_FP,	 /* Floating Point related preset events */

	/* Pentium 4 specific section */
	PAPI_PENT4_ENUM_GROUPS = 0x100,	/* 45 groups + custom + user */
	PAPI_PENT4_ENUM_COMBOS,	 /* all combinations of mask bits for given group */
	PAPI_PENT4_ENUM_BITS,	 /* all individual bits for given group */

	/* POWER 4 specific section */
	PAPI_PWR4_ENUM_GROUPS = 0x200	/* Enumerate groups an event belongs to */
};

typedef struct _papi_address_map
{
	char mapname[PAPI_HUGE_STR_LEN];
	caddr_t text_start;				   /* Start address of program text segment */
	caddr_t text_end;				   /* End address of program text segment */
	caddr_t data_start;				   /* Start address of program data segment */
	caddr_t data_end;				   /* End address of program data segment */
	caddr_t bss_start;				   /* Start address of program bss segment */
	caddr_t bss_end;				   /* End address of program bss segment */
} PAPI_address_map_t;

/*
 * PAPI 3 beta 3 introduces new structures for static memory description.
 * These include structures for tlb and cache description, a structure
 * to describe a level in the memory hierarchy, and a structure 
 * to describe all levels of the hierarchy.
 * These structures, and the requisite data types are defined below.
 */

   /* All sizes are in BYTES */
   /* Except tlb size, which is in entries */

#define PAPI_MAX_MEM_HIERARCHY_LEVELS 	  3
#define PAPI_MH_TYPE_EMPTY    0x0
#define PAPI_MH_TYPE_INST	   0x1
#define PAPI_MH_TYPE_DATA     0x2
#define PAPI_MH_TYPE_UNIFIED  PAPI_MH_TYPE_INST|PAPI_MH_TYPE_DATA

typedef struct _papi_mh_tlb_info
{
	int type;						   /* Empty, unified, data, instr */
	int num_entries;
	int associativity;
} PAPI_mh_tlb_info_t;

typedef struct _papi_mh_cache_info
{
	int type;						   /* Empty, unified, data, instr */
	int size;
	int line_size;
	int num_lines;
	int associativity;
} PAPI_mh_cache_info_t;

typedef struct _papi_mh_level_info
{
	PAPI_mh_tlb_info_t tlb[2];
	PAPI_mh_cache_info_t cache[2];
} PAPI_mh_level_t;

typedef struct _papi_mh_info
{									   /* mh for mem hierarchy maybe? */
	int levels;
	PAPI_mh_level_t level[PAPI_MAX_MEM_HIERARCHY_LEVELS];
} PAPI_mh_info_t;

/*
* Three data structures are modified in PAPI 3
* These modifications are 
* required to support the functionality of:
* PAPI_get_hardware_info() and
* PAPI_get_executable_info()
* These structures are reproduced below.
* They MUST stay synchronized with their counterparts in papi.h
* To avoid namespace collisions, these structures have been renamed
* to PAPIvi_xxx, and must also be renamed in your code.
*/
typedef struct _papi3_hw_info
{
	int ncpu;						   /* Number of CPUs in an SMP Node */
	int nnodes;						   /* Number of Nodes in the entire system */
	int totalcpus;					   /* Total number of CPUs in the entire system */
	int vendor;						   /* Vendor number of CPU */
	char vendor_string[PAPI_MAX_STR_LEN];	/* Vendor string of CPU */
	int model;						   /* Model number of CPU */
	char model_string[PAPI_MAX_STR_LEN];	/* Model string of CPU */
	float revision;					   /* Revision of CPU */
	float mhz;						   /* Cycle time of this CPU, *may* be estimated at 
									      init time with a quick timing routine */

	PAPI_mh_info_t mem_hierarchy;
} PAPIvi_hw_info_t;

typedef struct _papi3_preload_option
{
	char lib_preload_env[PAPI_MAX_STR_LEN];	/* Model string of CPU */
	char lib_preload_sep;
	char lib_dir_env[PAPI_MAX_STR_LEN];
	char lib_dir_sep;
} PAPIvi_preload_option_t;

typedef struct _papi3_program_info
{
	char fullname[PAPI_MAX_STR_LEN];   /* path+name */
	char name[PAPI_MAX_STR_LEN];	   /* name */
	PAPI_address_map_t address_info;
	PAPIvi_preload_option_t preload_info;
} PAPIvi_exe_info_t;


/*
* The Low Level API
* Functions in this API are classified in 4 basic categories:
* Modified:   13 functions
* New:         8 functions
* Unchanged:  32 functions
* Deprecated:  9 functions
*
* Each of these categories is discussed further below.
*/

/*
* Modified functions are further divided into 4 subcategories:
* Dereferencing changes: 6 functions
*     These functions simply substitute an EventSet value for
*     a pointer to an EventSet. In the case of PAPI_remove_event{s}()
*     there is also a name change.
* Name changes:          1 function
*     This is a simple name change with no change in functionality.
* Parameter changes:     4 functions
*     Several functions have changed functionality reflected in changed
*     parameters:
*     PAPI_{un}lock() supports multiple locks in PAPI 3
*     PAPI_profil() supports multiple bucket sizes in PAPI 3
*     PAPI_thread_init() removes an unused parameter in PAPI 3
* New functionality:     2 functions
*     These functions support new data in revised data structures
*     The code implemented here maps the old structures to the new
*     where possible.
*/

 /* Modified Functons: Dereferencing changes */
#define PAPIvi_add_event(EventSet, Event) \
          PAPI_add_event(&EventSet, Event)
#define PAPIvi_add_events(EventSet, Events, number) \
          PAPI_add_events(&EventSet, Events, number)
#define PAPIvi_cleanup_eventset(EventSet) \
          PAPI_cleanup_eventset(&EventSet)
#define PAPIvi_remove_event(EventSet, EventCode) \
          PAPI_rem_event(&EventSet, EventCode)
#define PAPIvi_remove_events(EventSet, Events, number) \
          PAPI_rem_events(&EventSet, Events, number)
#define PAPIvi_set_multiplex(EventSet) \
          PAPI_set_multiplex(&EventSet)

 /* Modified Functons: Name changes */
#define PAPIvi_is_initialized \
          PAPI_initialized

 /* Modified Functons: Parameter changes */
#define PAPIvi_lock(lck) \
          PAPI_lock()
#define PAPIvi_profil(buf, bufsiz, offset, scale, EventSet, EventCode, threshold, flags) \
          PAPI_profil((unsigned short *)buf, bufsiz, (unsigned long)offset, scale, EventSet, EventCode, threshold, flags)
#define PAPIvi_thread_init(id_fn) \
          PAPI_thread_init(id_fn, 0)
#define PAPIvi_unlock(lck) \
          PAPI_unlock()

 /* Modified Functons: New functionality */
static const PAPIvi_exe_info_t *
PAPIvi_get_executable_info( void )
{
	static PAPIvi_exe_info_t prginfo3;
	const PAPI_exe_info_t *prginfo2 = PAPI_get_executable_info(  );

	if ( prginfo2 == NULL )
		return ( NULL );

	strcpy( prginfo3.fullname, prginfo2->fullname );
	strcpy( prginfo3.name, prginfo2->name );
	prginfo3.address_info.mapname[0] = 0;
	prginfo3.address_info.text_start = prginfo2->text_start;
	prginfo3.address_info.text_end = prginfo2->text_end;
	prginfo3.address_info.data_start = prginfo2->data_start;
	prginfo3.address_info.data_end = prginfo2->data_end;
	prginfo3.address_info.bss_start = prginfo2->bss_start;
	prginfo3.address_info.bss_end = prginfo2->bss_end;
	strcpy( prginfo3.preload_info.lib_preload_env, prginfo2->lib_preload_env );

	return ( &prginfo3 );
}

static const PAPIvi_hw_info_t *
PAPIvi_get_hardware_info( void )
{
	static PAPIvi_hw_info_t papi3_hw_info;
	const PAPI_hw_info_t *papi2_hw_info = PAPI_get_hardware_info(  );
	const PAPI_mem_info_t *papi2_mem_info = PAPI_get_memory_info(  );

	/* Copy the basic hardware info (same in both structures */
	memcpy( &papi3_hw_info, papi2_hw_info, sizeof ( PAPI_hw_info_t ) );

	memset( &papi3_hw_info.mem_hierarchy, 0, sizeof ( PAPI_mh_info_t ) );
	/* check for a unified tlb */
	if ( papi2_mem_info->total_tlb_size &&
		 papi2_mem_info->itlb_size == 0 && papi2_mem_info->dtlb_size == 0 ) {
		papi3_hw_info.mem_hierarchy.level[0].tlb[0].type = PAPI_MH_TYPE_UNIFIED;
		papi3_hw_info.mem_hierarchy.level[0].tlb[0].num_entries =
			papi2_mem_info->total_tlb_size;
	} else {
		if ( papi2_mem_info->itlb_size ) {
			papi3_hw_info.mem_hierarchy.level[0].tlb[0].type =
				PAPI_MH_TYPE_INST;
			papi3_hw_info.mem_hierarchy.level[0].tlb[0].num_entries =
				papi2_mem_info->itlb_size;
			papi3_hw_info.mem_hierarchy.level[0].tlb[0].associativity =
				papi2_mem_info->itlb_assoc;
		}
		if ( papi2_mem_info->dtlb_size ) {
			papi3_hw_info.mem_hierarchy.level[0].tlb[1].type =
				PAPI_MH_TYPE_DATA;
			papi3_hw_info.mem_hierarchy.level[0].tlb[1].num_entries =
				papi2_mem_info->dtlb_size;
			papi3_hw_info.mem_hierarchy.level[0].tlb[1].associativity =
				papi2_mem_info->dtlb_assoc;
		}
	}
	/* check for a unified level 1 cache */
	if ( papi2_mem_info->total_L1_size )
		papi3_hw_info.mem_hierarchy.levels = 1;
	if ( papi2_mem_info->total_L1_size &&
		 papi2_mem_info->L1_icache_size == 0 &&
		 papi2_mem_info->L1_dcache_size == 0 ) {
		papi3_hw_info.mem_hierarchy.level[0].cache[0].type =
			PAPI_MH_TYPE_UNIFIED;
		papi3_hw_info.mem_hierarchy.level[0].cache[0].size =
			papi2_mem_info->total_L1_size << 10;
	} else {
		if ( papi2_mem_info->L1_icache_size ) {
			papi3_hw_info.mem_hierarchy.level[0].cache[0].type =
				PAPI_MH_TYPE_INST;
			papi3_hw_info.mem_hierarchy.level[0].cache[0].size =
				papi2_mem_info->L1_icache_size << 10;
			papi3_hw_info.mem_hierarchy.level[0].cache[0].associativity =
				papi2_mem_info->L1_icache_assoc;
			papi3_hw_info.mem_hierarchy.level[0].cache[0].num_lines =
				papi2_mem_info->L1_icache_lines;
			papi3_hw_info.mem_hierarchy.level[0].cache[0].line_size =
				papi2_mem_info->L1_icache_linesize;
		}
		if ( papi2_mem_info->L1_dcache_size ) {
			papi3_hw_info.mem_hierarchy.level[0].cache[1].type =
				PAPI_MH_TYPE_DATA;
			papi3_hw_info.mem_hierarchy.level[0].cache[1].size =
				papi2_mem_info->L1_dcache_size << 10;
			papi3_hw_info.mem_hierarchy.level[0].cache[1].associativity =
				papi2_mem_info->L1_dcache_assoc;
			papi3_hw_info.mem_hierarchy.level[0].cache[1].num_lines =
				papi2_mem_info->L1_dcache_lines;
			papi3_hw_info.mem_hierarchy.level[0].cache[1].line_size =
				papi2_mem_info->L1_dcache_linesize;
		}
	}

	/* check for level 2 cache info */
	if ( papi2_mem_info->L2_cache_size ) {
		papi3_hw_info.mem_hierarchy.levels = 2;
		papi3_hw_info.mem_hierarchy.level[1].cache[0].type =
			PAPI_MH_TYPE_UNIFIED;
		papi3_hw_info.mem_hierarchy.level[1].cache[0].size =
			papi2_mem_info->L2_cache_size << 10;
		papi3_hw_info.mem_hierarchy.level[1].cache[0].associativity =
			papi2_mem_info->L2_cache_assoc;
		papi3_hw_info.mem_hierarchy.level[1].cache[0].num_lines =
			papi2_mem_info->L2_cache_lines;
		papi3_hw_info.mem_hierarchy.level[1].cache[0].line_size =
			papi2_mem_info->L2_cache_linesize;
	}

	/* check for level 3 cache info */
	if ( papi2_mem_info->L3_cache_size ) {
		papi3_hw_info.mem_hierarchy.levels = 3;
		papi3_hw_info.mem_hierarchy.level[2].cache[0].type =
			PAPI_MH_TYPE_UNIFIED;
		papi3_hw_info.mem_hierarchy.level[2].cache[0].size =
			papi2_mem_info->L3_cache_size << 10;
		papi3_hw_info.mem_hierarchy.level[2].cache[0].associativity =
			papi2_mem_info->L3_cache_assoc;
		papi3_hw_info.mem_hierarchy.level[2].cache[0].num_lines =
			papi2_mem_info->L3_cache_lines;
		papi3_hw_info.mem_hierarchy.level[2].cache[0].line_size =
			papi2_mem_info->L3_cache_linesize;
	}

	return ( &papi3_hw_info );
}

/*
* New functions are either supported or unsupported.
* Of the three supported functions, two replaced deprecated functions
* to describe events, and one is simply a convenience function.
* The five unsupported new functions include three related to thread
* functionality, a convenience function to return the number of events
* in an event set, and a function to query information about shared libraries.
*/

 /* New Supported Functions */
static int
PAPIvi_enum_event( int *EventCode, int modifier )
{
	int i = *EventCode;
	const PAPI_preset_info_t *presets = PAPI_query_all_events_verbose(  );
	i &= PAPI_PRESET_AND_MASK;
	while ( ++i < PAPI_MAX_PRESET_EVENTS ) {
		if ( ( !modifier ) || ( presets[i].avail ) ) {
			*EventCode = i | PAPI_PRESET_MASK;
			if ( presets[i].event_name != NULL )
				return ( PAPI_OK );
			else
				return ( PAPI_ENOEVNT );
		}
	}
	return ( PAPI_ENOEVNT );
}

static int
PAPIvi_get_event_info( int EventCode, PAPI_event_info_t * info )
{
	int i;
	const PAPI_preset_info_t *info2 = PAPI_query_all_events_verbose(  );

	i = EventCode & PAPI_PRESET_AND_MASK;
	if ( ( i >= PAPI_MAX_PRESET_EVENTS ) || ( info2[i].event_name == NULL ) )
		return ( PAPI_ENOTPRESET );

	info->event_code = info2[i].event_code;
	info->count = info2[i].avail;
	if ( info2[i].flags & PAPI_DERIVED ) {
		info->count++;
		strcpy( info->derived, "DERIVED" );
	}
	if ( info2[i].event_name == NULL )
		info->symbol[0] = 0;
	else
		strcpy( info->symbol, info2[i].event_name );
	if ( info2[i].event_label == NULL )
		info->short_descr[0] = 0;
	else
		strcpy( info->short_descr, info2[i].event_label );
	if ( info2[i].event_descr == NULL )
		info->long_descr[0] = 0;
	else
		strcpy( info->long_descr, info2[i].event_descr );
	if ( info2[i].event_note == NULL )
		info->note[0] = 0;
	else
		strcpy( info->note, info2[i].event_note );
	return ( PAPI_OK );
}

/*
static int PAPI_get_multiplex(int EventSet)
{
   PAPI_option_t popt;
   int retval;

   popt.multiplex.eventset = EventSet;
   retval = PAPI_get_opt(PAPI_GET_MULTIPLEX, &popt);
   if (retval < 0)
      retval = 0;
   return retval;
}
*/

 /* New Unsupported Functions */
#define PAPIvi_get_shared_lib_info \
          PAPI_get_shared_lib_info
#define PAPIvi_get_thr_specific(tag, ptr) \
          PAPI_get_thr_specific(tag, ptr)
#define PAPIvi_num_events(EventSet) \
          PAPI_num_events(EventSet)
#define PAPIvi_register_thread \
          PAPI_register_thread
#define PAPIvi_set_thr_specific(tag, ptr) \
          PAPI_set_thr_specific(tag, ptr)

/*
* Over half of the functions in the Low Level API remain unchanged
* These are included in the macro list in case they do change in future
* revisions, and to simplify the naming conventions for writing 
* version independent PAPI code.
*/

#define PAPIvi_accum(EventSet, values) \
          PAPI_accum(EventSet, values)
#define PAPIvi_create_eventset(EventSet) \
          PAPI_create_eventset(EventSet)
#define PAPIvi_destroy_eventset(EventSet) \
          PAPI_destroy_eventset(EventSet)
#define PAPIvi_event_code_to_name(EventCode, out) \
          PAPI_event_code_to_name(EventCode, out)
#define PAPIvi_event_name_to_code(in, out) \
          PAPI_event_name_to_code(in, out)
#define PAPIvi_get_dmem_info(option) \
          PAPI_get_dmem_info(option)
#define PAPIvi_get_opt(option, ptr) \
          PAPI_get_opt(option, ptr)
#define PAPIvi_get_real_cyc \
          PAPI_get_real_cyc
#define PAPIvi_get_real_usec \
          PAPI_get_real_usec
#define PAPIvi_get_virt_cyc \
          PAPI_get_virt_cyc
#define PAPIvi_get_virt_usec \
          PAPI_get_virt_usec
#define PAPIvi_library_init(version) \
          PAPI_library_init(version)
#define PAPIvi_list_events(EventSet, Events, number) \
          PAPI_list_events(EventSet, Events, number)
#define PAPIvi_multiplex_init \
          PAPI_multiplex_init
#define PAPIvi_num_hwctrs \
          PAPI_num_hwctrs
#define PAPIvi_overflow(EventSet, EventCode, threshold, flags, handler) \
          PAPI_overflow(EventSet, EventCode, threshold, flags, handler)
#define PAPIvi_perror( s ) \
          PAPI_perror( s )
#define PAPIvi_query_event(EventCode) \
          PAPI_query_event(EventCode)
#define PAPIvi_read(EventSet, values) \
          PAPI_read(EventSet, values)
#define PAPIvi_reset(EventSet) \
          PAPI_reset(EventSet)
#define PAPIvi_set_debug(level) \
          PAPI_set_debug(level)
#define PAPIvi_set_domain(domain) \
          PAPI_set_domain(domain)
#define PAPIvi_set_granularity(granularity) \
          PAPI_set_granularity(granularity)
#define PAPIvi_set_opt(option, ptr) \
          PAPI_set_opt(option, ptr)
#define PAPIvi_shutdown \
          PAPI_shutdown
#define PAPIvi_sprofil(prof, profcnt, EventSet, EventCode, threshold, flags) \
          PAPI_sprofil(prof, profcnt, EventSet, EventCode, threshold, flags)
#define PAPIvi_start(EventSet) \
          PAPI_start(EventSet)
#define PAPIvi_state(EventSet, status) \
          PAPI_state(EventSet, status)
#define PAPIvi_stop(EventSet, values) \
          PAPI_stop(EventSet, values)
#define PAPIvi_strerror(err) \
          PAPI_strerror(err)
#define PAPIvi_thread_id \
          PAPI_thread_id
#define PAPIvi_write(EventSet, values) \
          PAPI_write(EventSet, values)

/*
* Of the nine functions deprecated from PAPI 2 to PAPI 3,
* three (PAPI_add_pevent, PAPI_restore, and PAPI_save) were
* never implemented, and four dealt with describing events.
* Two remain:
* PAPI_get_overflow_address() must still be used in version specific overflow handlers
* PAPI_profil_hw() was rarely used, and only on platforms supporting hardware overflow.
* The prototypes of these functions are shown below for completeness.
*/
/*
int PAPI_add_pevent(int *EventSet, int code, void *inout);
void *PAPI_get_overflow_address(void *context);
int PAPI_profil_hw(unsigned short *buf, unsigned bufsiz, unsigned long offset, \
          unsigned scale, int EventSet, int EventCode, int threshold, int flags);
const PAPI_preset_info_t *PAPI_query_all_events_verbose(void);
int PAPI_describe_event(char *name, int *EventCode, char *description);
int PAPI_label_event(int EventCode, char *label);
int PAPI_query_event_verbose(int EventCode, PAPI_preset_info_t *info);
int PAPI_restore(void);
int PAPI_save(void);
*/


/*
* The High Level API
* There are 8 functions in this API.
* 6 are unchanged, and 2 are new.
* Of the new functions, one is emulated and one is unsupported.
*/

/* Unchanged Functions */
#define PAPIvi_accum_counters(values, array_len) \
          PAPI_accum_counters(values, array_len)
#define PAPIvi_num_counters \
          PAPI_num_counters
#define PAPIvi_read_counters(values, array_len) \
          PAPI_read_counters(values, array_len)
#define PAPIvi_start_counters(Events, array_len) \
          PAPI_start_counters(Events, array_len)
#define PAPIvi_stop_counters(values, array_len) \
          PAPI_stop_counters(values, array_len)
#define PAPIvi_flops(rtime, ptime, flpops, mflops) \
          PAPI_flops(rtime, ptime, flpops, mflops)

 /* New Supported Functions */
#define PAPIvi_flips(rtime, ptime, flpins, mflips) \
          PAPI_flops(rtime, ptime, flpins, mflips)

 /* New Unupported Functions */
#define PAPIvi_ipc(rtime, ptime, ins, ipc) \
          PAPI_ipc(rtime, ptime, ins, ipc)


/*******************************************************************************
* If PAPI_VERSION is defined, and the MAJOR version number is 3,
* then papi.h is for PAPI 3.
* The preprocessor block below contains definitions and macros needed to 
* allow version independent linking to the PAPI 3 library.
* Other than a handful of definitions to support calls to PAPI_{get,set}_opt(),
* this layer simply converts version independent names to PAPI 3 library calls.
********************************************************************************/
#elif (PAPI_VERSION_MAJOR(PAPI_VERSION) == 3)

/*
* The following option definitions reflect the fact that PAPI 2 had separate 
* definitions for options to PAPI_set_opt and PAPI_get_opt, while PAPI 3 has
* only a single set for both. By using the older naming convention, you can 
* create platform independent code for these calls.
*/

#define PAPI_SET_DEBUG     PAPI_DEBUG
#define PAPI_GET_DEBUG     PAPI_DEBUG

#define PAPI_SET_MULTIPLEX PAPI_MULTIPLEX
#define PAPI_GET_MULTIPLEX PAPI_MULTIPLEX

#define PAPI_SET_DEFDOM    PAPI_DEFDOM
#define PAPI_GET_DEFDOM    PAPI_DEFDOM

#define PAPI_SET_DOMAIN    PAPI_DOMAIN
#define PAPI_GET_DOMAIN    PAPI_DOMAIN

#define PAPI_SET_DEFGRN    PAPI_DEFGRN
#define PAPI_GET_DEFGRN    PAPI_DEFGRN

#define PAPI_SET_GRANUL    PAPI_GRANUL
#define PAPI_GET_GRANUL    PAPI_GRANUL

#define PAPI_SET_INHERIT   PAPI_INHERIT
#define PAPI_GET_INHERIT   PAPI_INHERIT

#define PAPI_GET_NUMCTRS   PAPI_NUMCTRS
#define PAPI_SET_NUMCTRS   PAPI_NUMCTRS

#define PAPI_SET_PROFIL    PAPI_PROFIL
#define PAPI_GET_PROFIL    PAPI_PROFIL

/*
* These macros are simple pass-throughs to PAPI 3 structures
*/
#define PAPIvi_hw_info_t   PAPI_hw_info_t
#define PAPIvi_exe_info_t  PAPI_exe_info_t

/*
* The following macros are simple pass-throughs to PAPI 3 library calls
*/
 /* The Low Level API */
#define PAPIvi_accum(EventSet, values) \
          PAPI_accum(EventSet, values)
#define PAPIvi_add_event(EventSet, Event) \
          PAPI_add_event(EventSet, Event)
#define PAPIvi_add_events(EventSet, Events, number) \
          PAPI_add_events(EventSet, Events, number)
#define PAPIvi_cleanup_eventset(EventSet) \
          PAPI_cleanup_eventset(EventSet)
#define PAPIvi_create_eventset(EventSet) \
          PAPI_create_eventset(EventSet)
#define PAPIvi_destroy_eventset(EventSet) \
          PAPI_destroy_eventset(EventSet)
#define PAPIvi_enum_event(EventCode, modifier) \
          PAPI_enum_event(EventCode, modifier)
#define PAPIvi_event_code_to_name(EventCode, out) \
          PAPI_event_code_to_name(EventCode, out)
#define PAPIvi_event_name_to_code(in, out) \
          PAPI_event_name_to_code(in, out)
#define PAPIvi_get_dmem_info(option) \
          PAPI_get_dmem_info(option)
#define PAPIvi_get_event_info(EventCode, info) \
          PAPI_get_event_info(EventCode, info)
#define PAPIvi_get_executable_info \
          PAPI_get_executable_info
#define PAPIvi_get_hardware_info \
          PAPI_get_hardware_info
#define PAPIvi_get_multiplex(EventSet) \
          PAPI_get_multiplex(EventSet)
#define PAPIvi_get_opt(option, ptr) \
          PAPI_get_opt(option, ptr)
#define PAPIvi_get_real_cyc \
          PAPI_get_real_cyc
#define PAPIvi_get_real_usec \
          PAPI_get_real_usec
#define PAPIvi_get_shared_lib_info \
          PAPI_get_shared_lib_info
#define PAPIvi_get_thr_specific(tag, ptr) \
          PAPI_get_thr_specific(tag, ptr)
#define PAPIvi_get_virt_cyc \
          PAPI_get_virt_cyc
#define PAPIvi_get_virt_usec \
          PAPI_get_virt_usec
#define PAPIvi_is_initialized \
          PAPI_is_initialized
#define PAPIvi_library_init(version) \
          PAPI_library_init(version)
#define PAPIvi_list_events(EventSet, Events, number) \
          PAPI_list_events(EventSet, Events, number)
#define PAPIvi_lock(lck) \
          PAPI_lock(lck)
#define PAPIvi_multiplex_init \
          PAPI_multiplex_init
#define PAPIvi_num_hwctrs \
          PAPI_num_hwctrs
#define PAPIvi_num_events(EventSet) \
          PAPI_num_events(EventSet)
#define PAPIvi_overflow(EventSet, EventCode, threshold, flags, handler) \
          PAPI_overflow(EventSet, EventCode, threshold, flags, handler)
#define PAPIvi_perror( s ) \
          PAPI_perror( s )
#define PAPIvi_profil(buf, bufsiz, offset, scale, EventSet, EventCode, threshold, flags) \
          PAPI_profil(buf, bufsiz, offset, scale, EventSet, EventCode, threshold, flags)
#define PAPIvi_query_event(EventCode) \
          PAPI_query_event(EventCode)
#define PAPIvi_read(EventSet, values) \
          PAPI_read(EventSet, values)
#define PAPIvi_register_thread \
          PAPI_register_thread
#define PAPIvi_remove_event(EventSet, EventCode) \
          PAPI_remove_event(EventSet, EventCode)
#define PAPIvi_remove_events(EventSet, Events, number) \
          PAPI_remove_events(EventSet, Events, number)
#define PAPIvi_reset(EventSet) \
          PAPI_reset(EventSet)
#define PAPIvi_set_debug(level) \
          PAPI_set_debug(level)
#define PAPIvi_set_domain(domain) \
          PAPI_set_domain(domain)
#define PAPIvi_set_granularity(granularity) \
          PAPI_set_granularity(granularity)
#define PAPIvi_set_multiplex(EventSet) \
          PAPI_set_multiplex(EventSet)
#define PAPIvi_set_opt(option, ptr) \
          PAPI_set_opt(option, ptr)
#define PAPIvi_set_thr_specific(tag, ptr) \
          PAPI_set_thr_specific(tag, ptr)
#define PAPIvi_shutdown \
          PAPI_shutdown
#define PAPIvi_sprofil(prof, profcnt, EventSet, EventCode, threshold, flags) \
          PAPI_sprofil(prof, profcnt, EventSet, EventCode, threshold, flags)
#define PAPIvi_start(EventSet) \
          PAPI_start(EventSet)
#define PAPIvi_state(EventSet, status) \
          PAPI_state(EventSet, status)
#define PAPIvi_stop(EventSet, values) \
          PAPI_stop(EventSet, values)
#define PAPIvi_strerror(err) \
          PAPI_strerror(err)
#define PAPIvi_thread_id \
          PAPI_thread_id
#define PAPIvi_thread_init(id_fn) \
          PAPI_thread_init(id_fn)
#define PAPIvi_unlock(lck) \
          PAPI_unlock(lck)
#define PAPIvi_write(EventSet, values) \
          PAPI_write(EventSet, values)

   /* The High Level API */

#define PAPIvi_accum_counters(values, array_len) \
          PAPI_accum_counters(values, array_len)
#define PAPIvi_num_counters \
          PAPI_num_counters
#define PAPIvi_read_counters(values, array_len) \
          PAPI_read_counters(values, array_len)
#define PAPIvi_start_counters(Events, array_len) \
          PAPI_start_counters(Events, array_len)
#define PAPIvi_stop_counters(values, array_len) \
          PAPI_stop_counters(values, array_len)
#define PAPIvi_flips(rtime, ptime, flpins, mflips) \
          PAPI_flips(rtime, ptime, flpins, mflips)
#define PAPIvi_flops(rtime, ptime, flpops, mflops) \
          PAPI_flops(rtime, ptime, flpops, mflops)
#define PAPIvi_ipc(rtime, ptime, ins, ipc) \
          PAPI_ipc(rtime, ptime, ins, ipc)


/*******************************************************************************
* If PAPI_VERSION is defined, and the MAJOR version number is not 3, then we
* generate an error message.
* This block allows us to support future version with a 
* version independent syntax.
********************************************************************************/
#else
#error Compiling against a not yet released PAPI version
#endif

#endif /* _PAPIVI */