Index for Section 3

Alphabetical listing for P

Bottom of page

pthread_setspecific(3)
NAME
  pthread_setspecific - Sets the thread-specific data value associated with
  the specified key for the current thread

SYNOPSIS
  #include <pthread.h>

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

LIBRARY
  DECthreads POSIX 1003.1c Library (libpthread.so)

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

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

PARAMETERS
  key Thread-specific key that identifies the thread-specific data to receive
      value.  This key value must be obtained from pthread_key_create(3)).

  value
      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:

  0   Successful completion.

  [EINVAL]
      The specified key is invalid.

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

ERRORS
  None

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

  Manuals: Guide to DECthreads and Programmer's Guide

Index for Section 3

Alphabetical listing for P

Top of page