NAME    [Toc]    [Back]

       pthread_cond_destroy - Destroys a condition variable

SYNOPSIS    [Toc]    [Back]

       #include <pthread.h>

       int pthread_cond_destroy(
               pthread_cond_t *cond );

LIBRARY    [Toc]    [Back]

       DECthreads POSIX 1003.1c Library (libpthread.so)

STANDARDS    [Toc]    [Back]

       Interfaces  documented  on  this reference page conform to
       industry standards as follows:

       IEEE Std 1003.1c-1995, POSIX  System  Application  Program
       Interface

PARAMETERS    [Toc]    [Back]

       Condition variable to be destroyed.

DESCRIPTION    [Toc]    [Back]

       This  routine destroys the condition variable specified by
       cond. This effectively uninitializes the  condition  variable.
  Call this routine when a condition variable will no
       longer be  referenced.  Destroying  a  condition  variable
       allows  DECthreads  to  reclaim internal memory associated
       with the condition variable.

       It is safe to destroy an  initialized  condition  variable
       upon which no threads are currently blocked. Attempting to
       destroy a condition variable upon which other threads  are
       blocked results in unpredictable behavior.

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

RETURN VALUES    [Toc]    [Back]

       If  an  error  condition  occurs,  this routine returns an
       integer value  indicating  the  type  of  error.  Possible
       return  values are as follows: Successful completion.  The
       value specified by cond is invalid.  The object being referenced
 by cond is being referenced by another thread that
       is    currently    executing    pthread_cond_wait(3)    or
       pthread_cond_timedwait(3) on the condition variable specified
 in cond.

ERRORS    [Toc]    [Back]

       None

SEE ALSO    [Toc]    [Back]

       Functions:                      pthread_cond_broadcast(3),
       pthread_cond_init(3),              pthread_cond_signal(3),
       pthread_cond_timedwait(3), pthread_cond_wait(3)

       Manuals: Guide to DECthreads and Programmer's Guide



                                          pthread_cond_destroy(3)