NAME

pthread_cond_timedwait - Causes a thread to wait for a condition variable to be signaled or broadcast

SYNOPSIS

#include <pthread.h> int pthread_cond_timedwait( pthread_cond_t *cond, pthread_mutex_t *mutex,  struct timespec *abstime);

PARAMETERS

condCondition variable waited on. 

mutexMutex associated with the condition variable specified in cond. 

abstimeAbsolute time at which the wait expires, if the condition has not been signaled or broadcast. (See the pthread_get_expiration_np() routine, which you can use to obtain a value for this parameter.)

DESCRIPTION

The pthread_cond_timedwait() routine causes a thread to wait until one of the following occurs:

•The specified condition variable is signaled or broadcast. 

•The current system clock time is greater than or equal to the time specified by the abstime parameter. 

This routine is identical to pthread_cond_wait() except that this routine can return before a condition variable is signaled or broadcast—specifically, when a specified time expires. If the current time equals or exceeds the expiration time, this routine returns immediately, without causing the current thread to wait. Call this routine after you lock the mutex specified in mutex. The results of this routine are unpredictable if this routine is called without first locking the mutex.

RETURN VALUES

If the function fails, errno may be set to one of the following values:

RELATED INFORMATION

Functions:  pthread_cond_broadcast(3), pthread_cond_destroy(3), pthread_cond_init(3), pthread_cond_signal(3), pthread_cond_wait(3), pthread_get_expiration_np(3). 

Hewlett-Packard Company  —  OSF DCE 1.1/HP DCE 1.5