Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

tis_cond_wait(3) [osf1 man page]

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 broadcast. 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 error. Because no other thread exists to issue a call to tis_cond_sig- nal(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, refer to the pthread_cond_wait(3) description. RETURN VALUES
If an error condition occurs, this routine returns an integer value indicating the type of error. Possible return values are as follows: Successful completion. 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(3) operations on the same condition variable, or: The mutex 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)

Check Out this Related Man Page

pthread_cond_signal(3)					     Library Functions Manual					    pthread_cond_signal(3)

NAME
pthread_cond_signal - Wakes at least one thread that is waiting on the specified condition variable. LIBRARY
DECthreads POSIX 1003.1c Library (libpthread.so) SYNOPSIS
#include <pthread.h> int pthread_cond_signal( pthread_cond_t *cond); STANDARDS
Interfaces documented on this reference page conform to industry standards as follows: IEEE Std 1003.1c-1995, POSIX System Application Program Interface PARAMETERS
Condition variable to be signaled. DESCRIPTION
This routine unblocks at least one thread waiting on the specified condition variable cond. Calling this routine implies that data guarded by the associated mutex has changed, thus it might be possible for one of the waiting threads to proceed. In general, only one thread will be released. If no threads are waiting on the specified condition variable, this routine takes no action. The signal does not propagate to the next condition variable wait. This routine should be called when any thread waiting on the specified condition variable might find its predicate true, but only one thread should proceed. If more than one thread can proceed, or if any of the threads would not be able to proceed, then you must use pthread_cond_broadcast(3). The scheduling policy determines which thread is awakened. For policies SCHED_FIFO and SCHED_RR, a blocked thread is chosen in priority order, using first-in/first-out (FIFO) within priorities. If the calling thread holds the lock to the target condition variable's associated mutex while setting the variable's wait predicate, that thread can call pthread_cond_signal(3) to signal the variable even after releasing the lock on that mutex. However, for more predictable scheduling behavior, call pthread_cond_signal(3) before releasing the target condition variable's associated mutex. RETURN VALUES
If an error condition occurs, this routine returns an integer value indicating the type of error. Possible return values are as follows: Successful completion. The value specified by cond is not a valid condition variable. ERRORS
None RELATED INFORMATION
Functions: pthread_cond_broadcast(3), pthread_cond_destroy(3), pthread_cond_init(3), pthread_cond_timedwait(3), pthread_cond_wait(3) Manuals: Guide to DECthreads and Programmer's Guide delim off pthread_cond_signal(3)
Man Page

Featured Tech Videos