pthread_cond_destroy(3) 				     Library Functions Manual					   pthread_cond_destroy(3)

NAME

       pthread_cond_destroy - Destroys a condition variable.

LIBRARY

       DECthreads POSIX 1003.1c Library (libpthread.so)

SYNOPSIS

       #include <pthread.h>

       int pthread_cond_destroy(
			  pthread_cond_t  *cond);

STANDARDS

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

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

PARAMETERS

       Condition variable to be destroyed.

DESCRIPTION

       This  routine destroys the condition variable specified by cond.  This effectively uninitializes the condition variable.  Call this routine
       when a condition variable will no longer be referenced.	Destroying a condition variable allows DECthreads to reclaim internal memory asso-
       ciated with the condition variable.

       It  is  safe  to  destroy an initialized condition variable upon which no threads are currently blocked.  Attempting to destroy a condition
       variable upon which other threads are blocked results in unpredictable behavior.

       The results of this routine are unpredictable, if the condition variable specified in cond does not exist or is not initialized.

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 cond is invalid.  The object being referenced by cond is being referenced by another thread
       that is currently executing pthread_cond_wait(3) or pthread_cond_timedwait(3) on the condition variable specified in cond.

ERRORS

       None

RELATED INFORMATION

       Functions: pthread_cond_broadcast(3), pthread_cond_init(3), pthread_cond_signal(3), pthread_cond_timedwait(3), pthread_cond_wait(3)

       Manuals: Guide to DECthreads and Programmer's Guide

       delim off

															   pthread_cond_destroy(3)