PAPI_library_init - Online Linux Manual PageSection : 3
Updated : September, 2004
Source : PAPI Programmer's Reference
Note : PAPI

NAMEPAPI_library_init − initialize the PAPI library. PAPI_is_initialized − check for initialization.

SYNOPSISC Interface #include <papi.h> int PAPI_library_init(int version); int PAPI_is_initialized(void);Fortran Interface #include "fpapi.h" PAPIF_library_init(C_INT check) PAPIF_is_initialized(C_INT check)

DESCRIPTIONPAPI_library_init()" initializes the PAPI library. It must be called before any low level PAPI functions can be used. If your application is making use of threads "PAPI_thread_init(3) must also be called prior to making any calls to the library other than PAPI_library_init(). PAPI_is_initialized() returns the status of the PAPI library. The PAPI library can be in one of three states, as described under RETURN VALUES.

ARGUMENTSversion" -- upon initialization, PAPI checks the argument against the internal value of PAPI_VER_CURRENT" when the library was compiled. This guards against portability problems when updating the PAPI shared libraries on your system.

RETURN VALUESPAPI_library_init" : On success, this function returns PAPI_VER_CURRENT" . A positive return code other than PAPI_VER_CURRENT indicates a library version mis-match. A negative error code indicates an initialization error. PAPI_is_initialized": PAPI_NOT_INITED
 -- PAPI has not been initialized
PAPI_LOW_LEVEL_INITED
 -- PAPI_library_init has been called
PAPI_HIGH_LEVEL_INITED
 -- a high level PAPI function has been called

ERRORSPAPI_is_initialized never returns an error. PAPI_library_init can return the following: PAPI_EINVAL"  papi.h" is different from the version used to compile the PAPI library. PAPI_ENOMEM"  Insufficient memory to complete the operation. PAPI_ESBSTR"  This substrate does not support the underlying hardware. PAPI_ESYS"  A system or C library call failed inside PAPI, see the errno" variable.

EXAMPLESint retval; /* Initialize the library */ retval = PAPI_library_init(PAPI_VER_CURRENT); if (retval != PAPI_VER_CURRENT && retval > 0) { fprintf(stderr,"PAPI library version mismatch!\n"); exit(1); } if (retval < 0) handle_error(retval); retval = PAPI_is_initialized(); if (retval != PAPI_LOW_LEVEL_INITED) handle_error(retval);

BUGSIf you don't call this before using any of the low level PAPI calls, your application could core dump.

SEE ALSOPAPI_thread_init(3)," PAPI(3)"
0
Johanes Gumabo
Data Size   :   9,631 byte
man-PAPI_library_init.3Build   :   2024-12-29, 07:25   :  
Visitor Screen   :   x
Visitor Counter ( page / site )   :   7 / 256,589
Visitor ID   :     :  
Visitor IP   :   13.58.191.60   :  
Visitor Provider   :   AMAZON-02   :  
Provider Position ( lat x lon )   :   39.962500 x -83.006100   :   x
Provider Accuracy Radius ( km )   :   1000   :  
Provider City   :   Columbus   :  
Provider Province   :   Ohio ,   :   ,
Provider Country   :   United States   :  
Provider Continent   :   North America   :  
Visitor Recorder   :   Version   :  
Visitor Recorder   :   Library   :  
Online Linux Manual Page   :   Version   :   Online Linux Manual Page - Fedora.40 - march=x86-64 - mtune=generic - 24.12.29
Online Linux Manual Page   :   Library   :   lib_c - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Online Linux Manual Page   :   Library   :   lib_m - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Data Base   :   Version   :   Online Linux Manual Page Database - 24.04.13 - march=x86-64 - mtune=generic - fedora-38
Data Base   :   Library   :   lib_c - 23.02.07 - march=x86-64 - mtune=generic - fedora.36

Very long time ago, I have the best tutor, Wenzel Svojanovsky . If someone knows the email address of Wenzel Svojanovsky , please send an email to johanes_gumabo@yahoo.co.id .
If error, please print screen and send to johanes_gumabo@yahoo.co.id
Under development. Support me via PayPal.