cond_destroy(3scl)cond_destroy(3scl)NAMEcond_destroy - Destroys a condition variable.
LIBRARY
SCL Threads Library (libthread.so)
SYNOPSIS
#include <synch.h>
int cond_destroy(
cond_t *condp );
PARAMETERS
Address of the condition variable to be destroyed.
DESCRIPTION
This routine destroys the condition variable specified by condp. This
effectively un-initializes the condition variable.
SCL IMPLEMENTATION NOTEScond_destroy(3scl) is implemented by calling pthread_cond_destroy(3).
If pthread_cond_destroy(3) returns EINVAL, indicating that the condiā
tion variable is invalid (has not been initialized), then this routine
returns 0 to be consistent with the observed Solaris behaviour, and
logs an error-mapping message to the Solaris Compatibility Library
errorlog.
RETURN VALUES
If an error condition occurs, this routine returns an integer value
indicating the type of error.
Additional error return information may be written to the SCL error
log. Refer to scl_error_log(4scl) for details.
Possible return values are as follows: Successful completion. Or:
Error EINVAL from pthread_cond_destroy(3). A message is written to the
SCL errorlog which outlines outlines the error-code mapping.
pthread_cond_destroy(3) returned EBUSY, indicating that the specified
condition variable is being waited on by another thread executing
cond_wait(3scl) or cond_timedwait(3scl). A message is written to the
SCL errorlog which outlines the error-code mapping. Or:
An internal implementation error occurred. Refer to the SCL errorlog
for additional information.
Note: EFAULT is not returned if condp is an illegal address. An illegal
address generates a SIGSEGV signal, which by default will abort the
process and generate a core dump.
ERRORS
None.
RELATED INFORMATION
Functions: cond_broadcast(3scl), cond_init(3scl), cond_signal(3scl),
cond_timedwait(3scl), cond_wait(3scl), pthread_cond_destroy(3),
scl_intro(3scl), scl_thread_intro(3scl)
Files: scl_error_log(4scl)
Manuals: Solaris Compatibility Libraries User's Guide
cond_destroy(3scl)