NAME

PAPI_thread_init - initialize thread support in the PAPI library

CONTENTS

Synopsis
Description
Arguments
Return Values
Errors
Examples
Authors
Bugs
See Also

C Interface

#include <papi.h> 

int PAPI_thread_init (unsigned long int (*handle)()); 

Fortran Interface

#include fpapi.h 

PAPIF_thread_init(C_INT FUNCTION handle, C_INT check) 

PAPI_thread_init initializes thread support in the PAPI library. Itshould be called only once, just after PAPI_library_init (3), and before any other PAPI calls. Applications that make no use of threads do not need to call this routine.

handle -- Pointer to a function that returns current thread ID.

On success, this function returns PAPI_OK.
On error, a non-zero error code is returned.

PAPI_EINVAL
	One or more of the arguments is invalid.

For Pthreads:

if (PAPI_thread_init(pthread_self) != PAPI_OK)
  handle_error(1);

For OpenMP:

if (PAPI_thread_init(omp_get_thread_num) != PAPI_OK)
  handle_error(1);

The PAPI Team. See them at the PAPI Web Site: http://icl.cs.utk.edu/projects/papi

This function causes the application to exit if it is called more than once.

PAPI_library_init (3), PAPI_thread_id (3), PAPI_get_thr_specific (3), PAPI_set_thr_specific (3)