Blame man/man3/PAPI_event_name_to_code.3
|
Packit |
577717 |
.TH "PAPI_event_name_to_code" 3 "Mon Dec 18 2017" "Version 5.6.0.0" "PAPI" \" -*- nroff -*-
|
|
Packit |
577717 |
.ad l
|
|
Packit |
577717 |
.nh
|
|
Packit |
577717 |
.SH NAME
|
|
Packit |
577717 |
PAPI_event_name_to_code \-
|
|
Packit |
577717 |
.PP
|
|
Packit |
577717 |
Convert a name to a numeric hardware event code\&.
|
|
Packit |
577717 |
|
|
Packit |
577717 |
.SH SYNOPSIS
|
|
Packit |
577717 |
.br
|
|
Packit |
577717 |
.PP
|
|
Packit |
577717 |
.SH "Detailed Description"
|
|
Packit |
577717 |
.PP
|
|
Packit |
577717 |
|
|
Packit |
577717 |
.PP
|
|
Packit |
577717 |
.nf
|
|
Packit |
577717 |
@par C Interface:
|
|
Packit |
577717 |
\#include <papi.h> @n
|
|
Packit |
577717 |
int PAPI_event_name_to_code( const char * EventName, int * EventCode );
|
|
Packit |
577717 |
|
|
Packit |
577717 |
PAPI_event_name_to_code is used to translate an ASCII PAPI event name
|
|
Packit |
577717 |
into an integer PAPI event code.
|
|
Packit |
577717 |
|
|
Packit |
577717 |
@param *EventCode
|
|
Packit |
577717 |
The numeric code for the event.
|
|
Packit |
577717 |
@param *EventName
|
|
Packit |
577717 |
A string containing the event name as listed in PAPI_presets or discussed in PAPI_native.
|
|
Packit |
577717 |
|
|
Packit |
577717 |
@retval PAPI_EINVAL
|
|
Packit |
577717 |
One or more of the arguments is invalid.
|
|
Packit |
577717 |
@retval PAPI_ENOTPRESET
|
|
Packit |
577717 |
The hardware event specified is not a valid PAPI preset.
|
|
Packit |
577717 |
@retval PAPI_ENOINIT
|
|
Packit |
577717 |
The PAPI library has not been initialized.
|
|
Packit |
577717 |
@retval PAPI_ENOEVNT
|
|
Packit |
577717 |
The hardware event is not available on the underlying hardware.
|
|
Packit |
577717 |
|
|
Packit |
577717 |
@par Examples:
|
|
Packit |
577717 |
|
|
Packit |
577717 |
.fi
|
|
Packit |
577717 |
.PP
|
|
Packit |
577717 |
|
|
Packit |
577717 |
.PP
|
|
Packit |
577717 |
.nf
|
|
Packit |
577717 |
* int EventCode, EventSet = PAPI_NULL;
|
|
Packit |
577717 |
* // Convert to integer
|
|
Packit |
577717 |
* if ( PAPI_event_name_to_code( "PAPI_TOT_INS", &EventCode ) != PAPI_OK )
|
|
Packit |
577717 |
* handle_error( 1 );
|
|
Packit |
577717 |
* // Create the EventSet
|
|
Packit |
577717 |
* if ( PAPI_create_eventset( &EventSet ) != PAPI_OK )
|
|
Packit |
577717 |
* handle_error( 1 );
|
|
Packit |
577717 |
* // Add Total Instructions Executed to our EventSet
|
|
Packit |
577717 |
* if ( PAPI_add_event( EventSet, EventCode ) != PAPI_OK )
|
|
Packit |
577717 |
* handle_error( 1 );
|
|
Packit |
577717 |
*
|
|
Packit |
577717 |
|
|
Packit |
577717 |
.fi
|
|
Packit |
577717 |
.PP
|
|
Packit |
577717 |
.PP
|
|
Packit |
577717 |
\fBSee Also:\fP
|
|
Packit |
577717 |
.RS 4
|
|
Packit |
577717 |
\fBPAPI_event_code_to_name\fP
|
|
Packit |
577717 |
.PP
|
|
Packit |
577717 |
\fBPAPI_remove_event\fP
|
|
Packit |
577717 |
.PP
|
|
Packit |
577717 |
\fBPAPI_get_event_info\fP
|
|
Packit |
577717 |
.PP
|
|
Packit |
577717 |
\fBPAPI_enum_event\fP
|
|
Packit |
577717 |
.PP
|
|
Packit |
577717 |
\fBPAPI_add_event\fP
|
|
Packit |
577717 |
.PP
|
|
Packit |
577717 |
\fBPAPI_add_named_event\fP
|
|
Packit |
577717 |
.PP
|
|
Packit |
577717 |
PAPI_presets
|
|
Packit |
577717 |
.PP
|
|
Packit |
577717 |
PAPI_native
|
|
Packit |
577717 |
.RE
|
|
Packit |
577717 |
.PP
|
|
Packit |
577717 |
|
|
Packit |
577717 |
|
|
Packit |
577717 |
.SH "Author"
|
|
Packit |
577717 |
.PP
|
|
Packit |
577717 |
Generated automatically by Doxygen for PAPI from the source code\&.
|