35 lines
802 B
ReStructuredText
35 lines
802 B
ReStructuredText
PR_NotifyAllCondVar
|
|
===================
|
|
|
|
Notifies all of the threads waiting on a specified condition variable.
|
|
|
|
|
|
Syntax
|
|
------
|
|
|
|
.. code::
|
|
|
|
#include <prcvar.h>
|
|
|
|
PRStatus PR_NotifyAllCondVar(PRCondVar *cvar);
|
|
|
|
|
|
Returns
|
|
~~~~~~~
|
|
|
|
The function returns one of the following values:
|
|
|
|
- If successful, ``PR_SUCCESS``.
|
|
- If unsuccessful (for example, if the caller has not locked the lock
|
|
associated with the condition variable), ``PR_FAILURE``.
|
|
|
|
|
|
Description
|
|
-----------
|
|
|
|
The calling thread must hold the lock that protects the condition, as
|
|
well as the invariants that are tightly bound to the condition.
|
|
|
|
A call to :ref:`PR_NotifyAllCondVar` causes all of the threads waiting on
|
|
the specified condition variable to be promoted to a ready state. If no
|
|
threads are waiting, the operation is no-op.
|