osf1 man page for pthread_setspecific

pthread_setspecific(3)					     Library Functions Manual					    pthread_setspecific(3)

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

LIBRARY
       DECthreads POSIX 1003.1c Library (libpthread.so)

SYNOPSIS
       #include <pthread.h>

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

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

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

PARAMETERS
       Thread-specific	key  that  identifies  the  thread-specific  data to receive value.  This key value must be obtained from pthread_key_cre-
       ate(3)).  New thread-specific data value to associate with the specified key for the current thread.

DESCRIPTION
       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
       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
       None

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

       Manuals: Guide to DECthreads and Programmer's Guide

       delim off

															    pthread_setspecific(3)