Rechercher une page de manuel
PAPI_query_event
Langue: en
Version: September, 2004 (fedora - 01/12/10)
Section: 3 (Bibliothèques de fonctions)
NAME
PAPI_query_event - query if PAPI event exists
SYNOPSIS
C Interface#include <papi.h> int PAPI_query_event(int EventCode);Fortran Interface
#include fpapi.h PAPIF_query_event(C_INT EventCode, C_INT check)
DESCRIPTION
PAPI_query_event() asks the PAPI library if the PAPI Preset event can be counted on this architecture. If the event CAN be counted, the function returns PAPI_OK. If the event CANNOT be counted, the function returns an error code. This function also can be used to check the syntax of a native event.ARGUMENTS
EventCode -- a defined event such as PAPI_TOT_INS.RETURN VALUES
On success, PAPI_query_event returns PAPI_OKOn error, a non-zero error code is returned.
ERRORS
- PAPI_EINVAL
- One or more of the arguments is invalid.
- PAPI_ENOTPRESET
- The hardware event specified is not a valid PAPI preset.
- PAPI_ENOEVNT
- The PAPI preset is not available on the underlying hardware.
EXAMPLES
int retval; /* Initialize the library */ retval = PAPI_library_init(PAPI_VER_CURRENT); if (retval != PAPI_VER_CURRENT) { fprintf(stderr,"PAPI library init error!\n"); exit(1); } if (PAPI_query_event(PAPI_TOT_INS) != PAPI_OK) { fprintf(stderr,"No instruction counter? How lame.\n"); exit(1); }
BUGS
These functions have no known bugs.SEE ALSO
PAPI_preset(3), PAPI_native(3), PAPI_remove_event(3), PAPI_remove_events(3),Contenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre