Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

papi_event_code_to_name(3) [centos man page]

PAPI_event_code_to_name(3)					       PAPI						PAPI_event_code_to_name(3)

NAME
PAPI_event_code_to_name - Convert a numeric hardware event code to a name. SYNOPSIS
Detailed Description @par C Interface: int PAPI_event_code_to_name( int EventCode, char * EventName ); PAPI_event_code_to_name is used to translate a 32-bit integer PAPI event code into an ASCII PAPI event name. Either Preset event codes or Native event codes can be passed to this routine. Native event codes and names differ from platform to platform. @param EventCode The numeric code for the event. @param *EventName A string containing the event name as listed in PAPI_presets or discussed in PAPI_native. @retval PAPI_EINVAL One or more of the arguments is invalid. @retval PAPI_ENOTPRESET The hardware event specified is not a valid PAPI preset. @retval PAPI_ENOEVNT The hardware event is not available on the underlying hardware. @par Examples: * int EventCode, EventSet = PAPI_NULL; * int Event, number; * char EventCodeStr[PAPI_MAX_STR_LEN]; * // Create the EventSet * if ( PAPI_create_eventset( &EventSet ) != PAPI_OK ) * handle_error( 1 ); * // Add Total Instructions Executed to our EventSet * if ( PAPI_add_event( EventSet, PAPI_TOT_INS ) != PAPI_OK ) * handle_error( 1 ); * number = 1; * if ( PAPI_list_events( EventSet, &Event, &number ) != PAPI_OK ) * handle_error(1); * // Convert integer code to name string * if ( PAPI_event_code_to_name( Event, EventCodeStr ) != PAPI_OK ) * handle_error( 1 ); * printf( "Event Name: %s0, EventCodeStr ); * See Also: PAPI_event_name_to_code PAPI_remove_event PAPI_get_event_info PAPI_enum_event PAPI_add_event PAPI_presets PAPI_native Author Generated automatically by Doxygen for PAPI from the source code. Version 5.2.0.0 Tue Jun 17 2014 PAPI_event_code_to_name(3)

Check Out this Related Man Page

PAPI_add_named_event(3) 					       PAPI						   PAPI_add_named_event(3)

NAME
PAPI_add_named_event - add PAPI preset or native hardware event by name to an EventSet SYNOPSIS
Detailed Description @par C Interface: int PAPI_add_named_event( int EventSet, char *EventName ); PAPI_add_named_event adds one event to a PAPI EventSet. @n A hardware event can be either a PAPI preset or a native hardware event code. For a list of PAPI preset events, see PAPI_presets or run the avail test case in the PAPI distribution. PAPI presets can be passed to PAPI_query_event to see if they exist on the underlying architecture. For a list of native events available on current platform, run the papi_native_avail utility in the PAPI distribution. @param EventSet An integer handle for a PAPI Event Set as created by PAPI_create_eventset. @param EventCode A defined event such as PAPI_TOT_INS. @retval Positive-Integer The number of consecutive elements that succeeded before the error. @retval PAPI_EINVAL One or more of the arguments is invalid. @retval PAPI_ENOINIT The PAPI library has not been initialized. @retval PAPI_ENOMEM Insufficient memory to complete the operation. @retval PAPI_ENOEVST The event set specified does not exist. @retval PAPI_EISRUN The event set is currently counting events. @retval PAPI_ECNFLCT The underlying counter hardware can not count this event and other events in the event set simultaneously. @retval PAPI_ENOEVNT The PAPI preset is not available on the underlying hardware. @retval PAPI_EBUG Internal error, please send mail to the developers. @par Examples: * char EventName = "PAPI_TOT_INS"; * int EventSet = PAPI_NULL; * unsigned int native = 0x0; * if ( PAPI_create_eventset( &EventSet ) != PAPI_OK ) * handle_error( 1 ); * // Add Total Instructions Executed to our EventSet * if ( PAPI_add_named_event( EventSet, EventName ) != PAPI_OK ) * handle_error( 1 ); * // Add native event PM_CYC to EventSet * if ( PAPI_add_named_event( EventSet, "PM_CYC" ) != PAPI_OK ) * handle_error( 1 ); * @see PAPI_add_event @n PAPI_query_named_event @n PAPI_remove_named_event.fi Author Generated automatically by Doxygen for PAPI from the source code. Version 5.2.0.0 Tue Jun 17 2014 PAPI_add_named_event(3)
Man Page

Featured Tech Videos