tis_getspecific(3) [osf1 man page]

tis_getspecific(3)					     Library Functions Manual						tis_getspecific(3)

NAME

       tis_getspecific - Obtains the data associated with the specified thread-specific data key.

LIBRARY

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

SYNOPSIS

       #include <tis.h>

       void   *tis_getspecific(
				pthread_key_t	 key);

STANDARDS

       None

PARAMETERS

       Identifies  a  value returned by a call to tis_key_create(3).  This routine returns the data value associated with the thread-specific data
       key.

DESCRIPTION

       This routine returns the value currently bound to the specified thread-specific data key.

       This routine can be called from a data destructor function.

       When threads are present, the data and keys are thread specific; they enable a library to maintain context on a per-thread basis.

RETURN VALUES

       No errors are returned.	This routine returns the data value associated with the specified thread-specific data key key.  If no data  value
       is associated with key, or if key is not defined, then a NULL value is returned.

RELATED INFORMATION

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

       Manuals: Guide to DECthreads and Programmer's Guide

       delim off

																tis_getspecific(3)

tis_setspecific(3)					     Library Functions Manual						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

       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 asso-
       ciate 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:
       Successful completion.  The value specified by key is not a valid key.  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

       delim off

																tis_setspecific(3)