Source code
Revision control
Copy as Markdown
Other Tools
# PR_ExitMonitor
Decrements the entry count associated with a specified monitor and, if
the entry count reaches zero, releases the monitor's lock.
## Syntax
```{code}
#include <prmon.h>
PRStatus PR_ExitMonitor(PRMonitor *mon);
```
### Parameter
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 (the calling thread has not entered the monitor),
`PR_FAILURE`.
## Description
If the decremented entry count is zero, {ref}`PR_ExitMonitor` releases the
monitor's lock. Threads that were blocked trying to enter the monitor
will be rescheduled.