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

PR_NotifyAll should be used with some care. The expense of scheduling multiple threads increases dramatically as the number of threads increases.