pthread_key_delete(3) [osf1 man page]

pthread_key_delete(3)					     Library Functions Manual					     pthread_key_delete(3)

NAME

       pthread_key_delete - Deletes a thread-specific data key.

LIBRARY

       DECthreads POSIX 1003.1c Library (libpthread.so)

SYNOPSIS

       #include <pthread.h>

       int   pthread_key_delete(
			      pthread_key_t   key);

STANDARDS

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

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

PARAMETERS

       Context key to be deleted.

DESCRIPTION

       This  routine  deletes  the  thread-specific  data  key	specified  by  the  key  argument,  which  must  have  been previously returned by
       pthread_key_create(3).

       The thread-specific data values associated with key need not be NULL at the time this routine is called.  The  application  must  free  any
       application storage or perform any cleanup actions for data structures related to the deleted key or associated thread-specific data in any
       threads.  This cleanup can be done either before or after this routine is called.

       Do not attempt to use the key after calling this routine; this results in unpredictable behavior.

       No destructor functions are invoked by this routine.  Any destructor functions that may have been associated with key shall  no	longer	be
       called upon thread exit.  pthread_key_delete(3) can be called from within destructor functions.

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

ERRORS

       None

RELATED INFORMATION

       Functions: pthread_exit(3), pthread_getspecific(3), pthread_key_create(3)

       Manuals: Guide to DECthreads and Programmer's Guide

       delim off

															     pthread_key_delete(3)

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)