NAME¶
Ns_MasterLock, Ns_MasterUnlock - Enter and leave the single master critical
section lock
SYNOPSIS¶
#include "ns.h"
void
Ns_MasterLock(void)
void
Ns_MasterUnlock(void)
DESCRIPTION¶
The single master critical section lock is used throughout the core server to
protect portions of code from being run by more than one thread at a time.
These are convenience functions which actually make calls to
Ns_CsEnter
and
Ns_CsLeave to perform the locking and unlocking function.
You should not use these functions in your modules. To protect critical sections
in your modules you should create and initialize your own named locks, then
wrap your critical sections with calls to
Ns_CsEnter and
Ns_CsLeave.
- Ns_MasterLock()
-
Enter the single master lock. The thread that holds this lock is guaranteed
exclusive access to the section of code that follows the call to
Ns_MasterLock. Other threads that attempt to enter the master
critical section while another thread owns the master lock will block
until the owning thread releases the master lock.
Be extremely careful with code you place within the master critical section.
If the thread that owns the master lock blocks for any reason while in the
master critical section, other threads that need to enter that section of
code will block until the master lock is released.
- Ns_MasterUnlock()
-
Leave the single master critical section. The thread that owns the lock must
release it after the critical section of code has completed so that other
threads may execute the critical section code.
SEE ALSO¶
nsd(1), info(n),
Ns_CsEnter(3),
Ns_CsLeave(3)
KEYWORDS¶