MUTEX_LOCK(D3)

NAME
     MUTEX_LOCK - acquire a mutual exclusion lock

SYNOPSIS
     #include <sys/ksynch.h>
     #include <sys/ddi.h>
     void MUTEX_LOCK(mutex_t *lockp, int priority);

   Arguments
     lockp     Pointer to the mutual exclusion lock to be acquired.

     priority  Reserved for future use (must be equal to -1).

DESCRIPTION
     MUTEX_LOCK acquires the mutual exclusion lock specified by lockp.  If the
     lock is not immediately available, the calling thread of execution blocks
     until the lock becomes available to the caller, at which point the caller
     is reactivated and returns with the lock held.

     The caller will not be interrupted by signals while sleeping inside
     MUTEX_LOCK.

     MUTEX_LOCK differs from SLEEP_LOCK in that it implements priority
     inheritance -- the owner of the lock inherits the scheduling priority of
     any callers waiting for the lock if any of the waiters are running at a
     higher priority than the owner.  The original priority is reinstated when
     the lock is released.

   Return Values
     None

   Level
     Base only.

   Synchronization Constraints
     Can sleep.

     Driver-defined basic locks may not be held across calls to this function.

     Driver-defined sleep locks may be held across calls to this function
     subject to the recursion restrictions described below.

   Warnings
     Mutual exclusion locks are not recursive -- a call to MUTEX_LOCK
     attempting to acquire a lock that is currently held by the calling thread
     of execution will result in deadlock.

REFERENCES
     MUTEX_ALLOC(D3), MUTEX_INIT(D3), MUTEX_DEALLOC(D3), MUTEX_DESTROY(D3),
     MUTEX_TRYLOCK(D3), MUTEX_UNLOCK(D3), MUTEX_OWNED(D3), MUTEX_MINE(D3),
     SLEEP_LOCK(D3).