*** UNIX MANUAL PAGE BROWSER ***

pthread_setspecific(3) Library Functions Manual pthread_setspecific(3) NAME pthread_setspecific - Sets the thread-specific data value associated with the specified key for the current thread. LIBRARY DECthreads POSIX 1003.1c Library (libpthread.so) SYNOPSIS #include <pthread.h> int pthread_setspecific( pthread_key_t key, const void *value); STANDARDS Interfaces documented on this reference page conform to industry stan- dards as follows: IEEE Std 1003.1c-1995, POSIX System Application Program Interface PARAMETERS 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. DESCRIPTION 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 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- tion. 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. RETURN VALUES If an error condition occurs, this routine returns an integer value in- dicating 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. ERRORS None RELATED INFORMATION Functions: pthread_getspecific(3), pthread_key_create(3), pthread_key_delete(3) Manuals: Guide to DECthreads and Programmer's Guide delim off pthread_setspecific(3)