Index Index for
Section 3
Index Alphabetical
listing for P
Bottom of page Bottom of
page		 

pthread_self(3)


NAME

  pthread_self - Obtains the identifier of the calling thread


SYNOPSIS

  #include <pthread.h>

  pthread_t pthread_self(
	  void );


LIBRARY

  DECthreads POSIX 1003.1c Library (libpthread.so)


STANDARDS

  Interfaces documented on this reference page conform to industry standards
  as follows:

  IEEE Std 1003.1c-1995, POSIX System Application Program Interface


PARAMETERS

  None


DESCRIPTION

  This routine returns the address of the calling thread's own thread
  identifier. For example, you can use this thread object to obtain the
  calling thread's own sequence number.	 To do so, pass the return value from
  this routine in a call to the pthread_getsequence_np(3) routine, as
  follows:

	  unsigned long	    this_thread_nbr;
	   .
	   .
	   .
	  this_thread_nbr = pthread_getsequence_np( pthread_self( ) );
	   .
	   .
	   .

  The return value from the pthread_self(3) routine becomes meaningless after
  the calling thread is destroyed.


RETURN VALUES

  Returns the address of the calling thread's own thread object.


ERRORS

  None


SEE ALSO

  Functions: pthread_cancel(3), pthread_create(3), pthread_detach(3),
  pthread_exit(3), pthread_getsequence_np(3), pthread_join(3),
  pthread_kill(3), pthread_sigmask(3)

  Manuals: Guide to DECthreads and Programmer's Guide

Index Index for
Section 3
Index Alphabetical
listing for P
Top of page Top of
page