Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

pthread_getspecific(3c) [opensolaris man page]

pthread_getspecific(3C) 				   Standard C Library Functions 				   pthread_getspecific(3C)

NAME
pthread_getspecific, pthread_setspecific - manage thread-specific data SYNOPSIS
cc -mt [ flag... ] file... -lpthread [ library... ] #include <pthread.h> int pthread_setspecific(pthread_key_t key, const void *value); void *pthread_getspecific(pthread_key_t key); DESCRIPTION
The pthread_setspecific() function associates a thread-specific value with a key obtained by way of a previous call to pthread_key_cre- ate(). Different threads may bind different values to the same key. These values are typically pointers to blocks of dynamically allocated memory that have been reserved for use by the calling thread. The pthread_getspecific() function returns the value currently bound to the specified key on behalf of the calling thread. The effect of calling pthread_setspecific() or pthread_getspecific() with a key value not obtained from pthread_key_create() or after key has been deleted with pthread_key_delete() is undefined. Both pthread_setspecific() and pthread_getspecific() may be called from a thread-specific data destructor function. However, calling pthread_setspecific() from a destructor may result in lost storage or infinite loops. RETURN VALUES
The pthread_getspecific() function returns the thread-specific data value associated with the given key. If no thread-specific data value is associated with key, then the value NULL is returned. Upon successful completion, the pthread_setspecific() function returns 0. Otherwise, an error number is returned to indicate the error. ERRORS
The pthread_setspecific() function will fail if: ENOMEM Insufficient memory exists to associate the value with the key. The pthread_setspecific() function may fail if: EINVAL The key value is invalid. The pthread_getspecific() function does not return errors. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Standard | +-----------------------------+-----------------------------+ |MT-Level |MT-Safe | +-----------------------------+-----------------------------+ SEE ALSO
pthread_key_create(3C), attributes(5), standards(5) SunOS 5.11 23 Mar 2005 pthread_getspecific(3C)

Check Out this Related Man Page

pthread_getspecific(3T) 												   pthread_getspecific(3T)

NAME
pthread_getspecific(), pthread_setspecific() - get or set the thread-specific data associated with a key SYNOPSIS
PARAMETERS
key Thread-specific data key whose value for the calling thread is to be set or retrieved. value Value to be assigned to the thread-specific data key for the calling thread. DESCRIPTION
The function returns the thread-specific data value associated with key for the calling thread. If no value has been associated with key for the calling thread, NULL is returned. The function associates the thread-specific data value with key. Each thread may bind a different value to key. These values are usually pointers to memory dynamically allocated by the calling thread. key must be a valid thread-specific data key created by calling If key is not a valid thread-specific data key, undefined behavior results when calling these functions. These functions may be called from a thread-specific data destructor function. However, calling from a destructor may result in lost stor- age. RETURN VALUE
The function returns the thread-specific data value associated with key. If no thread-specific data value is currently associated with key, the value NULL is returned. If successful, returns zero. Otherwise, an error number is returned to indicate the error (the variable is not set). ERRORS
No errors are returned by the function. If any of the following occur, the function returns the corresponding error number: [ENOMEM] There is insufficient memory available in which to associate value with key. For each of the following conditions, if the condition is detected, the function returns the corresponding error number: [EINVAL] key is an invalid thread-specific data key. AUTHOR
and were derived from the IEEE POSIX P1003.1c standard. SEE ALSO
pthread_key_create(3T), pthread_key_delete(3T). STANDARDS CONFORMANCE
Pthread Library pthread_getspecific(3T)
Man Page