This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

pthread_cond_broadcast()

Unblock threads waiting on condition

Synopsis:

#include <pthread.h>

int pthread_cond_broadcast( pthread_cond_t* cond );

Arguments:

cond: A pointer to the pthread_cond_t object for which you want to unblock the threads.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The pthread_cond_broadcast() function unblocks all threads currently blocked on the condition variable cond. The threads are unblocked in priority order.

If more than one thread at a particular priority is blocked, those threads are unblocked in FIFO order.

Returns:

EOK: Success.
EFAULT: A fault occurred trying to access the buffers provided.
EINVAL: Invalid condition variable cond.

Classification:

POSIX 1003.1 THR

Safety:
Cancellation point	No
Interrupt handler	No
Signal handler	Yes
Thread	Yes