Join MDN and developers like you at Mozilla's View Source conference, 12-14 September in Berlin, Germany. Learn more at https://viewsourceconf.org

PR_CNotify

Notify a thread waiting on a change in the state of monitored data.

Syntax

#include <prcmon.h> 

PRStatus PR_CNotify(void *address);

Parameter

The function has the following parameter:

address
The address of the monitored object. The calling thread must be in the monitor defined by the value of the address.

Returns

  • PR_SUCCESS indicates that the calling thread is the holder of the mutex for the monitor referred to by the address parameter.
  • PR_FAILURE indicates that the monitor has not been entered by the calling thread.

Description

Using the value specified in the address parameter to find a monitor in the monitor cache, PR_CNotify notifies single a thread waiting for the monitor's state to change. If a thread is waiting on the monitor (having called PR_CWait), then that thread is made ready. As soon as the thread is scheduled, it attempts to reenter the monitor.

Document Tags and Contributors

 Contributors to this page: teoli, Rappo
 Last updated by: teoli,