39 lines
883 B
Markdown
39 lines
883 B
Markdown
# PR_NotifyAll
|
|
|
|
Promotes all threads waiting on a specified monitor to a ready state.
|
|
|
|
## Syntax
|
|
|
|
```{code}
|
|
#include <prmon.h>
|
|
|
|
PRStatus PR_NotifyAll(PRMonitor *mon);
|
|
```
|
|
|
|
### Parameters
|
|
|
|
The function has the following parameter:
|
|
|
|
`mon`
|
|
|
|
: A reference to an existing structure of type {ref}`PRMonitor`. The
|
|
monitor object referenced must be one for which the calling thread
|
|
currently holds the lock.
|
|
|
|
### Returns
|
|
|
|
The function returns one of the following values:
|
|
|
|
- If successful, `PR_SUCCESS`.
|
|
- If unsuccessful, `PR_FAILURE`.
|
|
|
|
## Description
|
|
|
|
A call to {ref}`PR_NotifyAll` causes all of the threads waiting on the
|
|
monitor to be scheduled to be promoted to a ready state. If no threads
|
|
are waiting, the operation is no-op.
|
|
|
|
{ref}`PR_NotifyAll` should be used with some care. The expense of
|
|
scheduling multiple threads increases dramatically as the number of
|
|
threads increases.
|