PAPI_thread_id

Langue: en

Version: September, 2004 (fedora - 01/12/10)

Section: 3 (Bibliothèques de fonctions)

NAME

PAPI_thread_id - get the thread identifier of the current thread

SYNOPSIS

C Interface
 #include <papi.h>
 unsigned long PAPI_thread_id(void);
 
Fortran Interface
 #include fpapi.h
 PAPIF_thread_id(C_INT id)
 

DESCRIPTION

This function returns a valid thread identifier. It calls the function registered with PAPI through a call to PAPI_thread_init().

ARGUMENTS

None.

RETURN VALUES

On success, this function returns PAPI_OK.
 On error, a negative error value is returned.

ERRORS

PAPI_EMISC
is returned if there are no threads registered.
-1
is returned if the thread id function returns an error.

EXAMPLE

 unsigned long tid;
 
 if ((tid = PAPI_thread_id()) == (unsigned long int)-1)
   exit(1);
 
 printf("Initial thread id is: %lu\n",tid);
 

BUGS

This function has no known bugs.

SEE ALSO

PAPI_thread_init(3)