pthread_setspecific(3)pthread_setspecific(3)NAMEpthread_setspecific - Sets the thread-specific data value associated
with the specified key for the current thread
const void *value );
DECthreads POSIX 1003.1c Library (libpthread.so)
Interfaces documented on this reference page conform to industry stan‐
dards as follows:
IEEE Std 1003.1c-1995, POSIX System Application Program Interface
Thread-specific key that identifies the thread-specific data to receive
value. This key value must be obtained from pthread_key_create(3)).
New thread-specific data value to associate with the specified key for
the current thread.
This routine sets the thread-specific data value associated with the
specified key for the current thread. If a value is defined for the key
in this thread (the current value is not NULL), the new value is sub‐
stituted for it. The key is obtained by a previous call to
Different threads can bind different values to the same key. These val‐
ues are typically pointers to blocks of dynamically allocated memory
that are reserved for use by the calling thread.
Do not call this routine from a thread-specific data destructor func‐
Note that although the type for value (void *) implies that it repre‐
sents an address, the type is being used as a “universal scalar type.”
DECthreads simply stores value for later retrieval.
If an error condition occurs, this routine returns an integer value
indicating the type of error. Possible return values are as follows:
Successful completion. The specified key is invalid. Insufficient
memory exists to associate the value with the key.
Functions: pthread_getspecific(3), pthread_key_create(3),
Manuals: Guide to DECthreads and Programmer's Guide