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)
