Index for Section 3

Alphabetical listing for P

Bottom of page

pthread_cond_destroy(3)
NAME
  pthread_cond_destroy - Destroys a condition variable

SYNOPSIS
  #include <pthread.h>

  int pthread_cond_destroy(
	  pthread_cond_t *cond );

LIBRARY
  DECthreads POSIX 1003.1c Library (libpthread.so)

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

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

PARAMETERS
  cond
      Condition variable to be destroyed.

DESCRIPTION
  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
  If an error condition occurs, this routine returns an integer value
  indicating the type of error. Possible return values are as follows:

  0   Successful completion.

  [EINVAL]
      The value specified by cond is invalid.

  [EBUSY]
      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
  None

SEE ALSO
  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

Index for Section 3

Alphabetical listing for P

Top of page