tis_setspecific(3)

Index for
Section 3
Alphabetical
listing for T
Bottom of
page
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.  Doing so could
  lead to a memory leak or an infinite loop.

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 value specified by key is not a valid key.

  [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
Index for
Section 3
Alphabetical
listing for T
Top of
page