pthread_cond_timedwait(3-thr) pthread_cond_timedwait(3-thr)
NAME
pthreadcondtimedwait - Veranlassen, daß ein Thread auf Signalisie-
rung oder Broadcasting einer Condition-Variablen wartet
SYNTAX
#include <pthread.h>
int pthreadcondtimedwait(
pthreadcondt *cond,
pthreadmutext *mutex,
struct timespec *abstime);
PARAMETER
cond Die Condition-Variable, auf die gewartet wird.
mutex Der Mutex, der zu der in cond angegebenen Condition-Variab-
len gehört.
abstime Die absolute Zeit, die gewartet wird, wenn die keine Signa-
lisierung oder kein Broadcasting der Condition-Variablen
erfolgt. (Siehe hierzu auch die Routine
pthreadgetexpirationnp(), die verwendet werden kann, um
einen Wert für diesen Parameter zu erhalten.)
BESCHREIBUNG
Die Routine pthreadcondtimedwait() veranlaßt einen Thread, so lange
zu warten, bis eine der folgenden Bedingungen eintritt:
- Es erfolgt eine Signalisierung oder ein Broadcasting der angegebe-
nen Condition-Variablen.
- Die im Parameter abstime angegebene absolute Zeit wurde von der
aktuellen Systemzeit erreicht oder überschritten.
Diese Routine entspricht der Routine pthreadcondwait() mit der Aus-
nahme, daß sie vor Signalisierung oder Broadcasting einer Condition-
Variabeln beendet werden kann - insbesondere dann, wenn eine angege-
bene Zeit abgelaufen ist.
Wenn die aktuelle Zeit die Ablaufzeit erreicht oder überschritten hat,
kehrt diese Routine sofort zurück, ohne daß der aktuelle Thread war-
tet.
Rufen Sie diese Routine erst auf, nachdem Sie den in mutex angegebenen
Mutex gesperrt haben. Die Ergebnisse dieser Routine sind unvorherseh-
bar, wenn sie aufgerufen wird, ohne daß zuvor der Mutex gesperrt
wurde.
Seite 1 Reliant UNIX 5.44 Gedruckt 11/98
pthread_cond_timedwait(3-thr) pthread_cond_timedwait(3-thr)
RÜCKGABEWERTE
Wenn die Funktion fehlschlägt, kann errno auf einen der folgenden
Werte gesetzt werden:
EINVAL Der durch cond, mutex oder abstime angegebene Wert ist
ungültig.
EAGAIN Die durch abstime angegebene Zeit ist abgelaufen.
EDEADLK Es liegt eine Deadlock-Bedingung vor.
SIEHE AUCH
pthreadcondbroadcast(3-thr), pthreadconddestroy(3-thr),
pthreadcondinit(3-thr), pthreadcondsignal(3-thr),
pthreadcondwait(3-thr), pthreadgetexpirationnp(3-thr).
Seite 2 Reliant UNIX 5.44 Gedruckt 11/98