PR_EnterMonitor

Enters the lock associated with a specified monitor.

Syntax

#include <prmon.h> 

void PR_EnterMonitor(PRMonitor *mon);

Parameter

The function has the following parameter:

mon
A reference to an existing structure of type PRMonitor.

Description

When the calling thread returns, it will have acquired the monitor's lock. Attempts to acquire the lock for a monitor that is held by some other thread will result in the caller blocking. The operation is neither timed nor interruptible.

If the monitor's entry count is greater than zero and the calling thread is recognized as the holder of the lock, PR_EnterMonitor increments the entry count by one and returns. If the entry count is greater than zero and the calling thread is not recognized as the holder of the lock, the thread is blocked until the entry count reaches zero. When the entry count reaches zero (or if it is already zero), the entry count is incremented by one and the calling thread is recorded as the lock's holder.

Document Tags and Contributors

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