NAME

    pthread_mutex_destroy - Deletes a mutex

 SYNOPSIS

     #include <pthread.h>

     int pthread_mutex_destroy( pthread_mutex_t *mutex );

 PARAMETERS

     mutex                Mutex to be deleted.

 DESCRIPTION

 The pthread_mutex_destroy() routine deletes a mutex and must be called
 when a mutex object is no longer referenced. The effect of calling this
 routine is to reclaim storage for the mutex object.

 It is illegal to delete a mutex that has a current owner (in other
 words, is locked).

 The results of this routine are unpredictable if the mutex object speci-
 fied in the mutex parameter does not currently exist.

 RETURN VALUES

 If the function fails, errno may be set to one of the following values:

    Return   Error      Description
    ________________________________________________________________
     0                  Successful completion.

    -1      [EBUSY]     An attempt was made to destroy a mutex
                        that is locked.

    -1      [EINVAL]    The value specified by mutex is invalid.

 RELATED INFORMATION

     FUNCTIONS:  pthread_mutex_init
                 pthread_mutex_lock
                 pthread_mutex_trylock
                 pthread_mutex_unlock