NAME    [Toc]    [Back]

       pthread_self  -  Obtains  the  identifier  of  the calling
       thread

SYNOPSIS    [Toc]    [Back]

       #include <pthread.h>

       pthread_t pthread_self(
               void );

LIBRARY    [Toc]    [Back]

       DECthreads POSIX 1003.1c Library (libpthread.so)

STANDARDS    [Toc]    [Back]

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

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

PARAMETERS    [Toc]    [Back]

       None

DESCRIPTION    [Toc]    [Back]

       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    [Toc]    [Back]

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

ERRORS    [Toc]    [Back]

       None

SEE ALSO    [Toc]    [Back]

       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



                                                  pthread_self(3)