Open System Services System Calls Reference Manual (G06.29+, H06.08+, J06.03+)

pthread_cond_broadcast(2) OSS System Calls Reference Manual
NAME
pthread_cond_broadcast - Unblocks all threads that are waiting on the specified condition vari-
able
LIBRARY
G-series native OSS processes: /G/system/sysnn/zsptsrl
32-bit H-series and J-series OSS processes that use the POSIX User Thread Model library:
/G/system/zdllnnn/zputdll
64-bit H-series and J-series OSS processes that use the POSIX User Thread Model library:
/G/system/zdllnnn/yputdll
H-series and J-series OSS processes that use the Standard POSIX Threads library:
/G/system/zdllnnn/zsptdll
SYNOPSIS
#include <pthread.h> | #include <spthread.h>
/* pthread.h is required to use POSIX User Thread Model library */
/* spthread.h is required to use Standard POSIX Threads library */
int pthread_cond_broadcast(
pthread_cond_t *cond);
PARAMETERS
cond Specifies a condition variable upon which the threads (to be awakened) are wait-
ing.
DESCRIPTION
This function unblocks all threads waiting on the condition variable specified by cond. Calling
this function implies that data guarded by the associated mutex has changed, so one or more
waiting threads might be able to proceed. The threads that are unblocked contend for the mutex
according to their respective scheduling policies (if applicable).
This function can be called by a thread regardless of whether it currently owns the mutex associ-
ated with the condition variable specified by cond. However, if predictable scheduling behavior
is required, the mutex must be locked before the pthread_cond_broadcast( ) function is called.
If no threads are waiting on the specified condition variable, this function takes no action. The
broadcast does not propagate to the next condition variable wait.
On systems running H06.21 or later H-series RVUs or J06.10 or later J-series RVUs, you can use
either the POSIX User Thread Model library or the Standard POSIX Threads library for threaded
applications.
To use this function in a threaded application that uses the POSIX User Thread Model library on
systems running H06.21 or later RVUs or J06.10 or later RVUs, you must perform all of the fol-
lowing tasks:
• Include the pthread.h header file in the application.
• Compile the application using the _PUT_MODEL_ feature test macro or equivalent
compiler command option.
• Link the application to the zputdll library (/G/system/zdllnnn/zputdll).
On systems running H06.24 or later H-series RVUs or J06.13 or later J-series RVUs, you can use
the POSIX User Thread Model library with 32-bit or 64-bit threaded applications.
To use this function in a 32-bit threaded application that uses the POSIX User Thread Model
library on systems running H06.24 or later RVUs or J06.13 or later RVUs, perform the same
tasks (described above) used to enable the POSIX User Thread Model library on systems running
H06.21/J06.10 or later RVUs.
5−84 Hewlett-Packard Company 527186-023