_lwp_mutex_unlock(2)                            _lwp_mutex_unlock(2)


       NAME
             _lwp_mutex_unlock - unlock a mutex

       SYNOPSIS
             #include <synch.h>
             int _lwp_mutex_unlock(lwp_mutex_t *mutex);

          Parameters
             mutex  pointer to mutex to be unlocked

       DESCRIPTION
             _lwp_mutex_unlock unlocks the mutex pointed to by mutex.

             If there are one or more lightweight processes (LWPs) waiting
             for the mutex when _lwp_mutex_unlock is called, at least one
             waiting LWP is allowed to attempt acquisition of the mutex.

          Return Values
             _lwp_mutex_unlock returns zero for success and an error number
             for failure, as described below.

          Errors
             If any of the following conditions is detected,
             _lwp_mutex_unlock fails and returns the corresponding value:

             EINVAL   The mutual exclusion variable pointed to by mutex is
                      invalid.

             EFAULT   The mutex parameter points to an illegal address.
                      (This error may not be detected; a SIGSEGV signal may
                      be posted to the faulting LWP if an illegal address
                      is used.)

       USAGE
             The locks acquired with _lwp_mutex_lock and _lwp_mutex_trylock
             should be released with _lwp_mutex_unlock.

       REFERENCES
             _lwp_mutex_lock(2), _lwp_mutex_trylock(2),
             mutex_destroy(3synch), mutex_init(3synch), mutex_lock(3synch),
             mutex_trylock(3synch), mutex_unlock(3synch)

       NOTICES
             Lightweight processes (LWPs) are internal interfaces and are
             subject to change.  Their use should be avoided.



                           Copyright 1994 Novell, Inc.               Page 1