[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]

Technical Reference: Base Operating System and Extensions, Volume 1

pthread_getunique_np Subroutine


Returns the sequence number of a thread


Threads Library (libpthreads.a)


#include <pthread.h>

int pthread_getunique_np ( thread, sequence)
pthread_t *thread;
int *sequence;


The pthread_getunique_np subroutine returns the sequence number of the thread thread. The sequence number is a number, unique to each thread, associated with the thread at creation time.

  1. The pthread.h header file must be the first included file of each source file using the threads library. Otherwise, the -D_THREAD_SAFE compilation flag should be used, or the cc_r compiler used. In this case, the flag is automatically set.
  2. The pthread_getunique_np subroutine is not portable.


thread Specifies the thread.
sequence Points to where the sequence number will be stored.

Return Values

Upon successful completion, the sequence number is returned via the sequence parameter, and 0 is returned. Otherwise, an error code is returned.

Error Codes

The pthread_getunique_np subroutine is unsuccessful if the following is true:

EINVAL The thread or sequence parameters are not valid.
ESRCH The thread thread does not exist.

Implementation Specifics

This subroutine is part of the Base Operating System (BOS) Runtime.

This subroutine is not POSIX compliant and is provided only for compatibility with DCE threads. It should not be used when writing new applications.

Related Information

The pthread_self (pthread_self Subroutine) subroutine.

[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]