Rechercher une page de manuel
PAPI_assign_eventset_component
Langue: en
Version: April, 2007 (fedora - 01/12/10)
Section: 3 (Bibliothèques de fonctions)
NAME
PAPI_assign_eventset_component - assign a component index to an existing but empty EventSetSYNOPSIS
C Interface#include <papi.h> PAPI_assign_eventset_component (int EventSet, int cidx);
DESCRIPTION
PAPI_assign_eventset_component() assigns a specific component index, as specified by cidx, to a new EventSet identified by EventSet, as obtained from PAPI_create_eventset(3). EventSets are ordinarily automatically bound to components when the first event is added. This routine is useful to explicitly bind an EventSet to a component before setting component related options.ARGUMENTS
EventSet -- An integer identifier for an existing EventSetcidx -- An integer identifier for a component. By convention, component 0 is always the cpu component.
RETURN VALUES
On success, this function returns PAPI_OK.
On error, a non-zero error code is returned.
ERRORS
- PAPI_ENOCMP
- The argument cidx is not a valid component.
- PAPI_ENOEVST
- The EventSet doesn't exist.
- PAPI_ENOMEM
- Insufficient memory to complete the operation.
EXAMPLES
int EventSet = PAPI_NULL; if (PAPI_create_eventset(&EventSet) != PAPI_OK) handle_error(1); /* Bind our EventSet to the cpu component */ if (PAPI_assign_eventset_component(EventSet, 0) != PAPI_OK) handle_error(1); /* Convert our EventSet to multiplexing */ if (PAPI_set_multiplex(EventSet) != PAPI_OK) handle_error(1);
BUGS
This function has no known bugs.SEE ALSO
PAPI_create_eventset(3), PAPI_add_event(3), PAPI_set_multiplex(3), PAPI_set_opt(3)Contenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre