|
Packit Service |
a1973e |
.TH "PAPI_assign_eventset_component" 3 "Mon Dec 18 2017" "Version 5.6.0.0" "PAPI" \" -*- nroff -*-
|
|
Packit Service |
a1973e |
.ad l
|
|
Packit Service |
a1973e |
.nh
|
|
Packit Service |
a1973e |
.SH NAME
|
|
Packit Service |
a1973e |
PAPI_assign_eventset_component \-
|
|
Packit Service |
a1973e |
.PP
|
|
Packit Service |
a1973e |
Assign a component index to an existing but empty EventSet\&.
|
|
Packit Service |
a1973e |
|
|
Packit Service |
a1973e |
.SH SYNOPSIS
|
|
Packit Service |
a1973e |
.br
|
|
Packit Service |
a1973e |
.PP
|
|
Packit Service |
a1973e |
.SH "Detailed Description"
|
|
Packit Service |
a1973e |
.PP
|
|
Packit Service |
a1973e |
|
|
Packit Service |
a1973e |
.PP
|
|
Packit Service |
a1973e |
.nf
|
|
Packit Service |
a1973e |
@par C Interface:
|
|
Packit Service |
a1973e |
\#include <papi.h> @n
|
|
Packit Service |
a1973e |
PAPI_assign_eventset_component( int EventSet, int cidx );
|
|
Packit Service |
a1973e |
|
|
Packit Service |
a1973e |
@param EventSet
|
|
Packit Service |
a1973e |
An integer identifier for an existing EventSet.
|
|
Packit Service |
a1973e |
@param cidx
|
|
Packit Service |
a1973e |
An integer identifier for a component.
|
|
Packit Service |
a1973e |
By convention, component 0 is always the cpu component.
|
|
Packit Service |
a1973e |
|
|
Packit Service |
a1973e |
@retval PAPI_ENOCMP
|
|
Packit Service |
a1973e |
The argument cidx is not a valid component.
|
|
Packit Service |
a1973e |
@retval PAPI_ENOEVST
|
|
Packit Service |
a1973e |
The EventSet doesn't exist.
|
|
Packit Service |
a1973e |
@retval PAPI_ENOMEM
|
|
Packit Service |
a1973e |
Insufficient memory to complete the operation.
|
|
Packit Service |
a1973e |
|
|
Packit Service |
a1973e |
PAPI_assign_eventset_component assigns a specific component index,
|
|
Packit Service |
a1973e |
as specified by cidx, to a new EventSet identified by EventSet, as obtained
|
|
Packit Service |
a1973e |
from PAPI_create_eventset. EventSets are ordinarily automatically bound
|
|
Packit Service |
a1973e |
to components when the first event is added. This routine is useful to
|
|
Packit Service |
a1973e |
explicitly bind an EventSet to a component before setting component related
|
|
Packit Service |
a1973e |
options.
|
|
Packit Service |
a1973e |
|
|
Packit Service |
a1973e |
@par Examples:
|
|
Packit Service |
a1973e |
|
|
Packit Service |
a1973e |
.fi
|
|
Packit Service |
a1973e |
.PP
|
|
Packit Service |
a1973e |
|
|
Packit Service |
a1973e |
.PP
|
|
Packit Service |
a1973e |
.nf
|
|
Packit Service |
a1973e |
* int EventSet = PAPI_NULL;
|
|
Packit Service |
a1973e |
* if ( PAPI_create_eventset( &EventSet ) != PAPI_OK )
|
|
Packit Service |
a1973e |
* handle_error( 1 );
|
|
Packit Service |
a1973e |
* // Bind our EventSet to the cpu component
|
|
Packit Service |
a1973e |
* if ( PAPI_assign_eventset_component( EventSet, 0 ) != PAPI_OK )
|
|
Packit Service |
a1973e |
* handle_error( 1 );
|
|
Packit Service |
a1973e |
* // Convert our EventSet to multiplexing
|
|
Packit Service |
a1973e |
* if ( PAPI_set_multiplex( EventSet ) != PAPI_OK )
|
|
Packit Service |
a1973e |
* handle_error( 1 );
|
|
Packit Service |
a1973e |
*
|
|
Packit Service |
a1973e |
|
|
Packit Service |
a1973e |
.fi
|
|
Packit Service |
a1973e |
.PP
|
|
Packit Service |
a1973e |
.PP
|
|
Packit Service |
a1973e |
\fBSee Also:\fP
|
|
Packit Service |
a1973e |
.RS 4
|
|
Packit Service |
a1973e |
\fBPAPI_set_opt\fP
|
|
Packit Service |
a1973e |
.br
|
|
Packit Service |
a1973e |
\fBPAPI_create_eventset\fP
|
|
Packit Service |
a1973e |
.br
|
|
Packit Service |
a1973e |
\fBPAPI_add_events\fP
|
|
Packit Service |
a1973e |
.br
|
|
Packit Service |
a1973e |
\fBPAPI_set_multiplex\fP
|
|
Packit Service |
a1973e |
.RE
|
|
Packit Service |
a1973e |
.PP
|
|
Packit Service |
a1973e |
|
|
Packit Service |
a1973e |
|
|
Packit Service |
a1973e |
.SH "Author"
|
|
Packit Service |
a1973e |
.PP
|
|
Packit Service |
a1973e |
Generated automatically by Doxygen for PAPI from the source code\&.
|