VMS Help DCE_THREADS, Application Routines, pthread_mutex_destroy  *Conan The Librarian (sorry for the slow response - running on an old VAX)

  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