MUTEX_DEALLOC(D3)

NAME
     MUTEX_DEALLOC, MUTEX_DESTROY - mutual exclusion lock de-initialization

SYNOPSIS
     #include <sys/ksynch.h>
     #include <sys/ddi.h>
     void MUTEX_DEALLOC(mutex_t *lockp);

     void MUTEX_DESTROY(mutex_t *lockp);

   Arguments
     lockp     Pointer to the mutual exclusion lock to be deallocated or
               decommissioned.

DESCRIPTION
     MUTEX_DEALLOC un-initializes and deallocates the mutual exclusion lock
     specified by lockp.  MUTEX_DESTROY un-initializes the mutual exclusion
     lock specified by lockp.  When the sleeping locks metering package is
     installed, this may involve deallocating metering data structures.

   Return Values
     None

USAGE
     Attempting to deallocate a lock that is currently locked or is being
     waited for is an error and results in undefined behavior.

   Level
     Base or Interrupt.

   Synchronization Constraints
     Does not sleep.

     Driver-defined basic locks, read/write locks, and sleep locks (other than
     the one being deallocated), may be held across calls to this function.

REFERENCES
     MUTEX_ALLOC(D3), MUTEX_INIT(D3), MUTEX_LOCK(D3), MUTEX_TRYLOCK(D3),
     MUTEX_UNLOCK(D3), MUTEX_OWNED(D3), MUTEX_MINE(D3),