Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

pthread_cond_broadcast(3)

pthread_cond_init(3)

pthread_cond_signal(3)

pthread_cond_timedwait(3)

pthread_cond_wait(3)

pthread_cond_destroy(3)  —  Subroutines

NAME

pthread_cond_destroy − Deletes a condition variable. 

SYNOPSIS

#include <pthread.h>
int pthread_cond_destroy(

pthread_cond_t ∗cond );

PARAMETERS

condCondition variable deleted. 

DESCRIPTION

This routine deletes a condition variable. Call this routine when a condition variable will no longer be 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 an error condition occurs, this routine returns −1 and sets errno to the corresponding error value. Possible return values are as follows:

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_wait or pthread_cond_timedwait on the condition variable specified in cond. 

RELATED INFORMATION

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

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026