Click this button to go to the index for this section.

tis_setspecific(3)
NAME
  tis_setspecific - Changes the value associated with the specified thread-
  specific data key.

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

SYNOPSIS
  #include <tis.h>

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

STANDARDS
  None

PARAMETERS
  key	    Thread-specific data Key that identifies the data to receive
	    value.  Must be obtained from a call to tis_key_create(3).

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

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 key value is invalid.

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




ERRORS
  None



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

  Manuals: Guide to DECthreads and Programmer's Guide