rmutex_destroy(3synch)                        rmutex_destroy(3synch)


       NAME
             rmutex_destroy - destroy a recursive mutex

       SYNOPSIS
             cc [options] -Kthread file
             #include <synch.h>
             int rmutex_destroy(rmutex_t *rmutex);

          Parameters
             rmutex pointer to recursive mutex to be destroyed

       DESCRIPTION
             rmutex_destroy destroys the recursive mutual exclusion lock
             (rmutex) pointed to by rmutex.  This includes invalidating the
             rmutex and freeing any associated implementation-allocated
             dynamic resources.

             Any user-allocated dynamic storage is unaffected by
             rmutex_destroy and must be explicitly released by the program.

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

          Errors
             If any of the following conditions is detected, rmutex_destroy
             returns the corresponding value:

             EBUSY    rmutex is locked by another thread or another thread
                      is waiting to acquire rmutex.

             EINVAL   Invalid argument specified.

             EINVAL   The rmutex pointed to by rmutex was already
                      destroyed.

       REFERENCES
             mutex(3synch), rmutex(3synch), rmutex_init(3synch),
             rmutex_lock(3synch), rmutex_trylock(3synch),
             rmutex_unlock(3synch), synch(3synch)








                           Copyright 1994 Novell, Inc.               Page 1