pthread_cond_destroy(3)pthread_cond_destroy(3)NAMEpthread_cond_destroy - Destroys a condition variable
SYNOPSIS
#include <pthread.h>
int pthread_cond_destroy(
pthread_cond_t *cond );
LIBRARY
DECthreads POSIX 1003.1c Library (libpthread.so)
STANDARDS
Interfaces documented on this reference page conform to industry stan‐
dards 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 associ‐
ated 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 vari‐
able upon which other threads are blocked results in unpredictable
behavior.
The results of this routine are unpredictable, if the condition vari‐
able 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_timed‐
wait(3) on the condition variable specified in cond.
ERRORS
None
SEE ALSO
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
pthread_cond_destroy(3)