*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> pthread_cond_destroy (3)              



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

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

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]


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

[ Back ]
 Similar pages
Name OS Title
tis_cond_destroy Tru64 Destroys the specified condition variable
pthread_condattr_destroy Tru64 Destroys a condition variable attributes object
pthread_cond_destroy FreeBSD destroy a condition variable
pthread_cond_init FreeBSD create a condition variable
cv_wait_sig FreeBSD kernel condition variable
cv_wait FreeBSD kernel condition variable
pthread_cond_wait FreeBSD wait on a condition variable
cv_init FreeBSD kernel condition variable
cv_destroy FreeBSD kernel condition variable
condvar FreeBSD kernel condition variable
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service