pthread_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 standards as follows:
IEEE Std 1003.1c-1995, POSIX System Application Program
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
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 substituted for it.
The key is obtained by a previous call to pthread_key_create(3).
Different threads can bind different values to the same
key. These values 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
Note that although the type for value (void *) implies
that it represents 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
[ Back ]