MUTEX_TRYLOCK(D3)

NAME
     MUTEX_TRYLOCK - try to acquire a sleep lock

SYNOPSIS
     #include <sys/types.h>
     #include <sys/ksynch.h>
     #include <sys/ddi.h>
     boolean_t MUTEX_TRYLOCK(mutex_t *lockp);

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

DESCRIPTION
     If the lock specified by lockp can be acquired without sleeping the
     MUTEX_TRYLOCK function acquires the lock.  If the lock is not immediately
     available, MUTEX_TRYLOCK returns without acquiring the lock.

   Return Values
     MUTEX_TRYLOCK returns TRUE (a non-zero value) if the lock is successfully
     acquired or FALSE (zero) if the lock is not acquired.

USAGE
   Level
     Base only.  This routine may not be called from Interrupt level.

   Synchronization Constraints
     Does not sleep.

     Driver-defined basic locks, read/write locks, other mutual exclusion
     locks and sleep locks may be held across calls to this function.

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