sousa-gecko/docs/nspr/reference/pr_notifyall.md

PR_NotifyAll

Promotes all threads waiting on a specified monitor to a ready state.

Syntax

#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.