Linux Manuals session 3

PAPI_num_hwctrs – Return the number of hardware counters on the cpu. SynopsisDetailed DescriptionSee Also: PAPI_num_cmp_hwctrsAuthorGenerated automatically by Doxygen for PAPI from the source code.

PAPI_num_events – Return the number of events in an event set. SynopsisDetailed DescriptionPAPI_num_events() returns the number of preset and/or native events contained in an event set. The event set should be created by PAPI_create_eventset . C Interface: #include <papi.h>  int PAPI_num_events(int  EventSet ); Parameters: EventSet — an integer handle for a PAPI event set created by PAPI_create_eventset. *count…

PAPI_num_counters – Get the number of hardware counters available on the system. SynopsisDetailed Description@par C Interface: #include <papi.h> @n int PAPI_num_counters( void );Postcondition: Initializes the library to PAPI_HIGH_LEVEL_INITED if necessary. Return values: PAPI_EINVAL papi.h is different from the version used to compile the PAPI library. PAPI_ENOMEM Insufficient memory to complete the operation. PAPI_ESYS A system…

PAPI_num_components – Get the number of components available on the system. SynopsisDetailed Description@return Number of components available on the system// Query the library for a component count. printf("%d components installed., PAPI_num_components() ); *   AuthorGenerated automatically by Doxygen for PAPI from the source code.

PAPI_num_cmp_hwctrs – Return the number of hardware counters for the specified component. SynopsisDetailed DescriptionPAPI_num_cmp_hwctrs() returns the number of counters present in the specified component. By convention, component 0 is always the cpu. On some components, especially for CPUs, the value returned is a theoretical maximum for estimation purposes only. It might not be possible to…

PAPI_multiplex_option_t – SynopsisData Fieldsint eventset int ns int flags Detailed DescriptionAuthorGenerated automatically by Doxygen for PAPI from the source code.

PAPI_multiplex_init – Initialize multiplex support in the PAPI library. SynopsisDetailed DescriptionPAPI_multiplex_init() enables and initializes multiplex support in the PAPI library. Multiplexing allows a user to count more events than total physical counters by time sharing the existing counters at some loss in precision. Applications that make no use of multiplexing do not need to call…

PAPI_mpx_info_t – SynopsisData Fieldsint timer_sig int timer_num int timer_us Detailed DescriptionField Documentationint PAPI_mpx_info_t::timer_numNumber of the itimer or POSIX 1 timer used by the multiplex timer: PAPI_ITIMER int PAPI_mpx_info_t::timer_sigSignal number used by the multiplex timer, 0 if not: PAPI_SIGNAL int PAPI_mpx_info_t::timer_usuS between switching of sets: PAPI_MPX_DEF_US AuthorGenerated automatically by Doxygen for PAPI from the source code.

PAPI_mh_tlb_info_t – SynopsisData Fieldsint type int num_entries int page_size int associativity Detailed DescriptionField Documentationint PAPI_mh_tlb_info_t::typeEmpty, instr, data, vector, unified AuthorGenerated automatically by Doxygen for PAPI from the source code.

PAPI_mh_level_t – SynopsisData FieldsPAPI_mh_tlb_info_t tlb [6] PAPI_mh_cache_info_t cache [6] Detailed DescriptionAuthorGenerated automatically by Doxygen for PAPI from the source code.

PAPI_mh_info_t – mh for mem hierarchy maybe? SynopsisData Fieldsint levels PAPI_mh_level_t level [4] AuthorGenerated automatically by Doxygen for PAPI from the source code.

PAPI_mh_cache_info_t – SynopsisData Fieldsint type int size int line_size int num_lines int associativity Detailed DescriptionField Documentationint PAPI_mh_cache_info_t::typeEmpty, instr, data, vector, trace, unified AuthorGenerated automatically by Doxygen for PAPI from the source code.

PAPI_lock – Lock one of two mutex variables defined in papi.h. SynopsisDetailed DescriptionPAPI_lock() grabs access to one of the two PAPI mutex variables. This function is provided to the user to have a platform independent call to a (hopefully) efficiently implemented mutex. C Interface: #include <papi.h> void PAPI_lock(int lock); Parameters: lock — an integer value…

PAPI_list_threads – List the registered thread ids. SynopsisDetailed DescriptionPAPI_list_threads() returns to the caller a list of all thread IDs known to PAPI. This call assumes an initialized PAPI library. C Interface #include <papi.h> int PAPI_list_threads(PAPI_thread_id_t *tids, int * number ); Parameters: *tids — A pointer to a preallocated array. This may be NULL to only…

PAPI_list_events – list the events in an event set SynopsisDetailed DescriptionList the events in an event set. PAPI_list_events() returns an array of events and a count of the total number of events in an event set. This call assumes an initialized PAPI library and a successfully created event set. C Interface #include <papi.h>  int PAPI_list_events(int *EventSet, int *Events, int *number );…

PAPI_library_init – initialize the PAPI library. SynopsisDetailed Description@param version upon initialization, PAPI checks the argument against the internal value of PAPI_VER_CURRENT when the library was compiled. This guards against portability problems when updating the PAPI shared libraries on your system. @retval PAPI_EINVAL papi.h is different from the version used to compile the PAPI library. @retval…

PAPI_itimer_option_t – SynopsisData Fieldsint itimer_num int itimer_sig int ns int flags Detailed DescriptionAuthorGenerated automatically by Doxygen for PAPI from the source code.

PAPI_is_initialized – check for initialization SynopsisDetailed Description@retval PAPI_NOT_INITED Library has not been initialized @retval PAPI_LOW_LEVEL_INITED Low level has called library init @retval PAPI_HIGH_LEVEL_INITED High level has called library init @retval PAPI_THREAD_LEVEL_INITED Threads have been inited @param version upon initialization, PAPI checks the argument against the internal value of PAPI_VER_CURRENT when the library was compiled. This…

PAPI_ipc – Simplified call to get instructions per cycle, real and processor time. SynopsisDetailed DescriptionC Interface: #include <papi.h> int PAPI_ipc( float *rtime, float *ptime, long long *ins, float *ipc ); Parameters: *rtime total realtime since the first call *ptime total process time since the first call *ins total instructions since the first call *ipc incremental…

PAPI_inherit_option_t – SynopsisData Fieldsint eventset int inherit Detailed DescriptionAuthorGenerated automatically by Doxygen for PAPI from the source code.