NAME    [Toc]    [Back]

       tis_setspecific  -  Changes  the value associated with the
       specified thread-specific data key

SYNOPSIS    [Toc]    [Back]

       #include <tis.h>

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

LIBRARY    [Toc]    [Back]

       Standard C Library (libc.so, libc.a)

STANDARDS    [Toc]    [Back]

       None

PARAMETERS    [Toc]    [Back]

       Thread-specific data  key  that  identifies  the  data  to
       receive   value.    Must   be  obtained  from  a  call  to
       tis_key_create(3).  New value to associate with the specified
  key. Once set, this value can be retrieved using the
       same key in a call to tis_getspecific(3).

DESCRIPTION    [Toc]    [Back]

       This routine sets the value associated with the  specified
       thread-specific  data  key.  If a value is defined for the
       key (that is, the current value  is  not  NULL),  the  new
       value is substituted for it. The key is obtained by a previous
 call to tis_key_create(3).

       Do not call this routine from a data destructor  function.
       Doing  so could lead to a memory leak or an infinite loop.

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
       value  specified  by key is not a valid key.  Insufficient
       memory exists to associate the value with the key.

ERRORS    [Toc]    [Back]

       None

SEE ALSO    [Toc]    [Back]

       Functions:     tis_getspecific(3),      tis_key_create(3),
       tis_key_delete(3)

       Manuals: Guide to DECthreads and Programmer's Guide



                                               tis_setspecific(3)