42 lines
1.5 KiB
ReStructuredText
42 lines
1.5 KiB
ReStructuredText
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.
|