papi_get_executable_info(3) [centos man page]

PAPI_get_executable_info(3)					       PAPI					       PAPI_get_executable_info(3)

NAME

       PAPI_get_executable_info -

       Get the executable's address space info.

SYNOPSIS

Detailed Description
       @par C Interface:
       const PAPI_exe_info_t *PAPI_get_executable_info( void );

       This function returns a pointer to a structure containing information
       about the current program.

       @param fullname
	   Fully qualified path + filename of the executable.
       @param name
	   Filename of the executable with no path information.
       @param text_start, text_end
	   Start and End addresses of program text segment.
       @param data_start, data_end
	   Start and End addresses of program data segment.
       @param bss_start, bss_end
	   Start and End addresses of program bss segment.

       @retval PAPI_EINVAL
	   One or more of the arguments is invalid.

       @par Examples:

       *   const PAPI_exe_info_t *prginfo = NULL;
       *   if ( ( prginfo = PAPI_get_executable_info( ) ) == NULL )
       *   exit( 1 );
       *   printf( "Path+Program: %s0, exeinfo->fullname );
       *   printf( "Program: %s0, exeinfo->address_info.name );
       *   printf( "Text start: %p, Text end: %p0, exeinfo->address_info.text_start, exeinfo->address_info.text_end) ;
       *   printf( "Data start: %p, Data end: %p0, exeinfo->address_info.data_start, exeinfo->address_info.data_end );
       *   printf( "Bss start: %p, Bss end: %p0, exeinfo->address_info.bss_start, exeinfo->address_info.bss_end );
       *

       See Also:
	   PAPI_get_opt

	   PAPI_get_hardware_info

	   PAPI_exe_info_t

Author
       Generated automatically by Doxygen for PAPI from the source code.

Version 5.2.0.0 						  Tue Jun 17 2014				       PAPI_get_executable_info(3)

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)