centos man page for papi_enum_event

Query: papi_enum_event

OS: centos

Section: 3

Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar

PAPI_enum_event(3)						       PAPI							PAPI_enum_event(3)

NAME
PAPI_enum_event - Enumerate PAPI preset or native events.
SYNOPSIS
Detailed Description @par C Interface: int PAPI_enum_event( int * EventCode, int modifer ); Given a preset or native event code, PAPI_enum_event replaces the event code with the next available event in either the preset or native table. 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 preset events, a TRUE (non-zero) value currently directs the function to return event codes only for PAPI preset events available on this platform. This may change in the future. For native events, the effect of the modifier argument is 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. @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 this platform * 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_event( &i, PAPI_ENUM_ALL ) == 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_cmp_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_event(3)
Related Man Pages
papi_add_named_event(3) - centos
papi_detach(3) - centos
papi_event_code_to_name(3) - centos
papi_overflow(3) - centos
xtapppeekevent(3) - hpux
Similar Topics in the Unix Linux Community
DJ Native Swing 0.9.2 (Default branch)
DJ Native Swing 0.9.4 (Default branch)
DJ Native Swing 0.9.5 (Default branch)
How does Unix write events into event log?
POWER Hardware