NAME    [Toc]    [Back]

     pthread_setspecific - set a thread-specific data value

SYNOPSIS    [Toc]    [Back]

     #include <pthread.h>

     int
     pthread_setspecific(pthread_key_t key, const void *value);

DESCRIPTION    [Toc]    [Back]

     The pthread_setspecific() function associates a  thread-specific value
     with    a    key   obtained   via   a   previous   call   to
pthread_key_create().  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 effect of calling pthread_setspecific() with a key value
not obtained
     from pthread_key_create() or after key has been deleted with
     pthread_key_delete() is undefined.

     pthread_setspecific() may be called from  a  thread-specific
data destructor
  function;  however,  this may result in lost storage or
infinite loops.

RETURN VALUES    [Toc]    [Back]

     If successful, the pthread_setspecific() function  will  return zero.  Otherwise
  an error number will be returned to indicate the error.

ERRORS    [Toc]    [Back]

     pthread_setspecific() will fail if:

     [ENOMEM]      Insufficient memory exists  to  associate  the
value with the
                   key.

     [EINVAL]      The key value is invalid.

SEE ALSO    [Toc]    [Back]

     pthread_getspecific(3),               pthread_key_create(3),
pthread_key_delete(3)

STANDARDS    [Toc]    [Back]

     pthread_setspecific()  conforms   to   ISO/IEC   9945-1:1996
(``POSIX'').

OpenBSD      3.6                           April      4,     1996