NAME    [Toc]    [Back]

       pthread_setspecific  - Sets the thread-specific data value
       associated with the specified key for the current thread

SYNOPSIS    [Toc]    [Back]

       #include <pthread.h>

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

LIBRARY    [Toc]    [Back]

       DECthreads POSIX 1003.1c Library (libpthread.so)

STANDARDS    [Toc]    [Back]

       Interfaces documented on this reference  page  conform  to
       industry standards as follows:

       IEEE  Std  1003.1c-1995,  POSIX System Application Program
       Interface

PARAMETERS    [Toc]    [Back]

       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    [Toc]    [Back]

       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 values 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 function.

       Note  that  although  the  type for value (void *) implies
       that it represents an address, the type is being used as a
       "universal  scalar  type."  DECthreads simply stores value
       for later retrieval.

RETURN VALUES    [Toc]    [Back]

       If an error condition  occurs,  this  routine  returns  an
       integer  value  indicating  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    [Toc]    [Back]

       None

SEE ALSO    [Toc]    [Back]

       Functions: pthread_getspecific(3),  pthread_key_create(3),
       pthread_key_delete(3)

       Manuals: Guide to DECthreads and Programmer's Guide



                                           pthread_setspecific(3)