NAME

PAPI_thread_id - get the thread identifier of the current thread

CONTENTS

Synopsis
Description
Arguments
Return Values
Errors
Example
Bugs
See Also

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)


PAPI Programmer’s Reference PAPI_thread_id (3) September, 2004

  Innovative Computing Laboratory
2001 R&D Winner  
Contact PAPI: papi@cs.utk.edu Computer Science Department
  University of Tennessee