blob: e7289d9b060fceebfb558e8abdc19b747b7da4ba (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
|
PR_NotifyCondVar
================
Notifies a condition variable of a change in its associated monitored
data.
Syntax
------
.. code::
#include <prcvar.h>
PRStatus PR_NotifyCondVar(PRCondVar *cvar);
Parameter
~~~~~~~~~
:ref:`PR_NotifyCondVar` has one parameter:
``cvar``
The condition variable to notify.
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.
Notification of a condition variable signals a change of state in some
monitored data. When the notification occurs, the runtime promotes a
thread that is waiting on the condition variable to a ready state. If
more than one thread is waiting, the selection of which thread gets
promoted cannot be predicted. This implies that all threads waiting on a
single condition variable must have the same semantics. If no thread is
waiting on the condition variable, the notify operation is a no-op.
|
