VMS Help
POSIX Threads, TIS routines, tis_cond_wait
*Conan The Librarian (sorry for the slow response - running on an old VAX)
|
|
Causes a thread to wait for the specified condition variable to
be signaled or broadcast.
#include <tis.h>
int
tis_cond_wait (
pthread_cond_t *cond,
pthread_mutex_t *mutex);
cond
Address of the condition variable (passed by reference) on which
to wait.
mutex
Address of the mutex (passed by reference) that is associated
with the condition variable specified in cond.
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
error. Because no other thread exists to issue a call to tis_
cond_signal() or tis_cond_broadcast(), using this routine in a
single-threaded environment forces the program to exit.
For further information about actions taken when threads are
present, refer to the pthread_cond_wait() description.
If an error condition occurs, this routine returns an integer
value indicating the type of error. Possible return values are as
follows:
Return Description
0 Successful completion.
[EINVAL] The value specified by cond is not a valid condition
variable or the value specified by mutex is not a
valid mutex, or
Different mutexes are supplied for concurrent
tis_cond_wait() operations on the same condition
variable, or
The mutex was not owned by the calling thread at the
time of the call.
tis_cond_broadcast()
tis_cond_destroy()
tis_cond_init()
tis_cond_signal()
[legal]
[privacy]
[GNU]
[policy]
[netiquette]
[sponsors]
[FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.