Source code
Revision control
Copy as Markdown
Other Tools
This chapter describes the NSPR API for creation and manipulation of a
mutex of type :ref:`PRLock`.
- `Lock Type <#Lock_Type>`__
- `Lock Functions <#Lock_Functions>`__
In NSPR, a mutex of type :ref:`PRLock` controls locking, and associated
condition variables communicate changes in state among threads. When a
programmer associates a mutex with an arbitrary collection of data, the
mutex provides a protective monitor around the data.
In general, a monitor is a conceptual entity composed of a mutex, one or
more condition variables, and the monitored data. Monitors in this
generic sense should not be confused with monitors used in Java
programming. In addition to :ref:`PRLock`, NSPR provides another mutex
type, :ref:`PRMonitor`, which is reentrant and can have only one associated
condition variable. :ref:`PRMonitor` is intended for use with Java and
reflects the Java approach to thread synchronization.
For an introduction to NSPR thread synchronization, including locks and
condition variables, see `Introduction to
NSPR <Introduction_to_NSPR>`__.
For reference information on NSPR condition variables, see `Condition
Variables <Condition_Variables>`__.
.. _Lock_Type:
Lock Type
---------
- :ref:`PRLock`
.. _Lock_Functions:
Lock Functions
--------------
- :ref:`PR_NewLock` creates a new lock object.
- :ref:`PR_DestroyLock` destroys a specified lock object.
- :ref:`PR_Lock` locks a specified lock object.
- :ref:`PR_Unlock` unlocks a specified lock object.