thr_keycreate(3scl)thr_keycreate(3scl)NAMEthr_keycreate - Generates a unique thread-specific data key.
LIBRARY
SCL Threads Library (libthread.so)
SYNOPSIS
#include <thread.h>
int thr_keycreate(
thread_key_t *key,
void (*destructor)( void * ) );
PARAMETERS
The new thread-specific data key. Procedure called to destroy a
thread-specific data value associated with the created key when a
thread terminates.
DESCRIPTION
This routine generates a unique, thread-specific data key that is visi‐
ble to all threads in the process.
A thread can set and get thread-specific data for a key by calling
thr_setspecific(3scl) and thr_getspecific(3scl).
SCL IMPLEMENTATION NOTESthr_keycreate(3scl) is implemented by calling pthread_key_create(3).
The POSIX threads library on Tru64 UNIX imposes a maximum number of
thread- specific data keys, equal to the symbolic constant
PTHREAD_KEYS_MAX in <pthread.h>. Note that the SCL thread library uses
several keys itself, which leaves less for applications.
RETURN VALUES
If an error condition occurs, this routine returns an integer value
indicating the type of error.
Additional error return information may be written to the SCL error
log. Refer to scl_error_log(4scl) for details.
Possible return values are as follows: Successful completion. The sys‐
tem lacked the necessary resources to create another thread-specific
data key. Or:
An internal implementation error occurred. Refer to the SCL errorlog
for additional information. Insufficient memory exists to create the
key.
ERRORS
None.
RELATED INFORMATION
Functions: pthread_key_create(3), pthread_getspecific(3), pthread_set‐
specific(3)scl_intro(3scl), scl_thread_intro(3scl), thr_getspe‐
cific(3scl), thr_setspecific(3scl)
Files: scl_error_log(4scl)
Manuals: Solaris Compatibility Libraries User's Guide
thr_keycreate(3scl)