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

AOLserver                                              4.0                                 Ns_Master(3aolserver)