NAME

pthread_cond_destroy — destroy a condition variable

LIBRARY

POSIX Threads Library (libpthread, -lpthread)

SYNOPSIS

#include <pthread.h>

int
pthread_cond_destroy(pthread_cond_t *cond);

DESCRIPTION

The pthread_cond_destroy() function frees the resources allocated by the condition variable cond.

IMPLEMENTATION NOTES

A condition variable can be destroyed immediately after all the threads that are blocked on it are awakened.

RETURN VALUES

If successful, the pthread_cond_destroy() function will return zero, otherwise an error number will be returned to indicate the error.

ERRORS

The pthread_cond_destroy() function will fail if:

[EINVAL]

The value specified by cond is invalid.

[EBUSY]

The variable cond is locked by another thread.

SEE ALSO

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

STANDARDS

The pthread_cond_destroy() function conforms to ISO/IEC 9945-1:1996 (“POSIX.1”).