Home
Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages

CentOS 7.0 - man page for papi_enum_cmp_event (centos section 3)

PAPI_enum_cmp_event(3)					 PAPI				       PAPI_enum_cmp_event(3)

NAME
PAPI_enum_cmp_event - Enumerate PAPI preset or native events for a given component.
SYNOPSIS
Detailed Description @par C Interface: int PAPI_enum_cmp_event( int *EventCode, int modifer, int cidx ); Given an event code, PAPI_enum_event replaces the event code with the next available event. The modifier argument affects which events are returned. For all platforms and event types, a value of PAPI_ENUM_ALL (zero) directs the function to return all possible events. @n For native events, the effect of the modifier argument may be different on each platform. See the discussion below for platform-specific definitions. @param *EventCode A defined preset or native event such as PAPI_TOT_INS. @param modifier Modifies the search logic. See below for full list. For native events, each platform behaves differently. See platform-specific documentation for details. @param cidx Specifies the component to search in @retval PAPI_ENOEVNT The next requested PAPI preset or native event is not available on the underlying hardware. @par Examples: * // Scan for all supported native events on the first component * printf( "Name Code Description0 ); * do { * retval = PAPI_get_event_info( i, &info ); * if ( retval == PAPI_OK ) { * printf( "%-30s 0x%-10x1s0, info.symbol, info.event_code, info.long_descr ); * } * } while ( PAPI_enum_cmp_event( &i, PAPI_ENUM_ALL, 0 ) == PAPI_OK ); * Generic Modifiers The following values are implemented for preset events o PAPI_ENUM_EVENTS -- Enumerate all (default) o PAPI_ENUM_FIRST -- Enumerate first event (preset or native) preset/native chosen based on type of EventCode Native Modifiers The following values are implemented for native events o PAPI_NTV_ENUM_UMASKS -- Given an event, iterate through possible umasks one at a time o PAPI_NTV_ENUM_UMASK_COMBOS -- Given an event, iterate through all possible combinations of umasks. This is not implemented on libpfm4. Preset Modifiers The following values are implemented for preset events o PAPI_PRESET_ENUM_AVAIL -- enumerate only available presets o PAPI_PRESET_ENUM_MSC -- Miscellaneous preset events o PAPI_PRESET_ENUM_INS -- Instruction related preset events o PAPI_PRESET_ENUM_IDL -- Stalled or Idle preset events o PAPI_PRESET_ENUM_BR -- Branch related preset events o PAPI_PRESET_ENUM_CND -- Conditional preset events o PAPI_PRESET_ENUM_MEM -- Memory related preset events o PAPI_PRESET_ENUM_CACH -- Cache related preset events o PAPI_PRESET_ENUM_L1 -- L1 cache related preset events o PAPI_PRESET_ENUM_L2 -- L2 cache related preset events o PAPI_PRESET_ENUM_L3 -- L3 cache related preset events o PAPI_PRESET_ENUM_TLB -- Translation Lookaside Buffer events o PAPI_PRESET_ENUM_FP -- Floating Point related preset events ITANIUM Modifiers The following values are implemented for modifier on Itanium: o PAPI_NTV_ENUM_IARR - Enumerate IAR (instruction address ranging) events o PAPI_NTV_ENUM_DARR - Enumerate DAR (data address ranging) events o PAPI_NTV_ENUM_OPCM - Enumerate OPC (opcode matching) events o PAPI_NTV_ENUM_IEAR - Enumerate IEAR (instr event address register) events o PAPI_NTV_ENUM_DEAR - Enumerate DEAR (data event address register) events POWER Modifiers The following values are implemented for POWER o PAPI_NTV_ENUM_GROUPS - Enumerate groups to which an event belongs See Also: PAPI PAPIF PAPI_enum_event PAPI_get_event_info PAPI_event_name_to_code PAPI_preset PAPI_native Author Generated automatically by Doxygen for PAPI from the source code. Version 5.2.0.0 Tue Jun 17 2014 PAPI_enum_cmp_event(3)


All times are GMT -4. The time now is 06:55 PM.

Unix & Linux Forums Content Copyright 1993-2018. All Rights Reserved.
UNIX.COM Login
Username:
Password:  
Show Password