Open System Services System Calls Reference Manual (G06.29+, H06.08+, J06.03+)

pthread_setspecific(2) OSS System Calls Reference Manual
NAME
pthread_setspecific - Sets the thread-specific data associated with a key
LIBRARY
G-series native OSS processes: /G/system/sysnn/zsptsrl
32-bit H-series and J-series OSS processes that use the POSIX User Thread Model library:
/G/system/zdllnnn/zputdll
64-bit H-series and J-series OSS processes that use the POSIX User Thread Model library:
/G/system/zdllnnn/yputdll
H-series and J-series OSS processes that use the Standard POSIX Threads library:
/G/system/zdllnnn/zsptdll
SYNOPSIS
#include <pthread.h> | #include <spthread.h>
/* pthread.h is required to use POSIX User Thread Model library */
/* spthread.h is required to use Standard POSIX Threads library */
int pthread_setspecific(
pthread_key_t key,
const void *value);
PARAMETERS
key Specifies the thread-specific key that identifies the thread-specific data to be set
to the new value. This key value is returned by the pthread_key_create() func-
tion.
value Specifies the new thread-specific data to associate with the key specified by key.
DESCRIPTION
This function sets the thread-specific data associated with the key specified by the key parameter
for the calling thread.
Different threads can bind different data to the same key. This data typically consists of pointers
to blocks of dynamically allocated memory that are reserved for use by the calling thread.
Although the data type of the value parameter (void *) implies that it represents an address, the
type is being used as a "universal scalar type." The system simply stores the value of value for
later retrieval.
On systems running H06.21 or later H-series RVUs or J06.10 or later J-series RVUs, you can use
either the POSIX User Thread Model library or the Standard POSIX Threads library for threaded
applications.
To use this function in a threaded application that uses the POSIX User Thread Model library on
systems running H06.21 or later RVUs or J06.10 or later RVUs, you must perform all of the fol-
lowing tasks:
• Include the pthread.h header file in the application.
• Compile the application using the _PUT_MODEL_ feature test macro or equivalent
compiler command option.
• Link the application to the zputdll library (/G/system/zdllnnn/zputdll).
On systems running H06.24 or later H-series RVUs or J06.13 or later J-series RVUs, you can use
the POSIX User Thread Model library with 32-bit or 64-bit threaded applications.
To use this function in a 32-bit threaded application that uses the POSIX User Thread Model
library on systems running H06.24 or later RVUs or J06.13 or later RVUs, perform the same
tasks (described above) used to enable the POSIX User Thread Model library on systems running
5−176 Hewlett-Packard Company 527186-023