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

  NAME

      pthread_cond_destroy - Deletes a condition variable

  SYNOPSIS

      #include <pthread.h>

      int pthread_cond_destroy(pthread_cond_t *cond);

  PARAMETERS

      cond                Condition variable deleted.

  DESCRIPTION

  The pthread_cond_destroy() routine deletes a condition variable. Call
  this routine when a condition variable is no longer referenced. The
  effect of calling this routine is to give permission to reclaim storage
  for the condition variable.

  The results of this routine are unpredictable if the condition variable
  specified in cond does not exist.

  The results of this routine are also unpredictable if there are threads
  waiting for the specified condition variable to be signaled or broadcast
  when it is deleted.

  RETURN VALUES

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

    Return   Error      Description
    ___________________________________________________________
     0                  Successful completion.

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

    -1      [EBUSY]     A thread is currently executing a
                        pthread_cond_timedwait() routine or
                        pthread_cond_wait() on the condition
                        variable specified in cond.

  RELATED INFORMATION

      FUNCTIONS:  pthread_cond_broadcast
                  pthread_cond_init
                  pthread_cond_signal
                  pthread_cond_timedwait
                  pthread_cond_wait