Manual Page Result
0
Command: tis_cond_wait | Section: 3 | Source: Digital UNIX | File: tis_cond_wait.3.gz
tis_cond_wait(3) Library Functions Manual tis_cond_wait(3)
NAME
tis_cond_wait - Causes a thread to wait for the specified condition
variable to be signaled or broadcasted.
LIBRARY
Standard C Library (libc.so, libc.a)
SYNOPSIS
#include <tis.h>
int tis_cond_wait(
pthread_cond_t *cond,
pthread_mutex_t *mutex);
STANDARDS
None
PARAMETERS
Address of the condition variable (passed by reference) on which to
wait. Address of the mutex (passed by reference) that is associated
with the condition variable specified in cond.
DESCRIPTION
When threads are present, this routine causes a thread to wait for the
specified condition variable cond to be signaled or broadcast.
Calling this routine in a single-threaded environment is a coding er-
ror. Because no thread can execute in parallel to issue a call to
tis_cond_signal(3) or tis_cond_broadcast(3), using this routine in a
single-threaded environment forces the program to exit.
For more information about actions taken when threads are present, re-
fer to the pthread_cond_wait(3) description.
RETURN VALUES
If an error condition occurs, this routine returns an integer value in-
dicating the type of error. Possible return values are as follows:
Successful completion. The value specified by cond, or mutex is in-
valid, or: Different mutexes are supplied for concurrent
tis_cond_wait(3) operations on the same condition variable, or: The mu-
tex was not owned by the calling thread at the time of the call.
ERRORS
None
RELATED INFORMATION
Functions: tis_cond_broadcast(3), tis_cond_destroy(3),
tis_cond_init(3), tis_cond_signal(3)
Manuals: Guide to DECthreads and Programmer's Guide
delim off
tis_cond_wait(3)