pthread_join(3-thr) pthread_join(3-thr)
NAME
pthreadjoin - Veranlassen, daß der aufrufende Thread auf die Beendi-
gung eines angegebenen Thread wartet
SYNTAX
#include <pthread.h>
int pthreadjoin(
pthreadt thread,
pthreadaddrt *status);
PARAMETER
thread Der Thread, auf dessen Beendigung der Aufrufer dieser Rou-
tine wartet.
status Statuswert des beendenden Thread, wenn dieser Thread
pthreadexit() aufruft.
BESCHREIBUNG
Die Routine pthreadjoin() veranlaßt, daß der aufrufende Thread auf
die Beendigung eines angegebenen Thread wartet. Ein Aufruf dieser Rou-
tine kehrt zurück, sobald der angegebene Thread beendet ist.
Diese Routine kann von einer beliebigen Anzahl Threads aufgerufen wer-
den. Alle Threads werden aktiviert, wenn der angegebene Thread beendet
ist.
Wenn diese Routine vom aktuellen Thread aufgerufen wird, um eine Ver-
knüpfung zu sich selbst herzustellen, wird ein Fehler zurückgegeben.
Die Ergebnisse dieser Routine sind unvorhersehbar, wenn der Wert für
thread auf ein nicht mehr vorhandenes Thread-Objekt verweist.
RÜCKGABEWERTE
Wenn der Thread normal beendet wird, ist der Exit-Status der Wert, der
optional von der Startroutine des Thread zurückgegeben wird.
Wenn die Funktion fehlschlägt, kann errno auf einen der folgenden
Werte gesetzt werden:
EINVAL Der durch thread angegebene Wert ist ungültig.
ESRCH Der durch thread angegebene Wert verweist nicht auf einen
derzeit existierenden Thread.
EDEADLK Es liegt eine Deadlock-Bedingung vor.
SIEHE AUCH
pthreadcreate(3-thr), pthreaddetach(3-thr), pthreadexit(3-thr).
Seite 1 Reliant UNIX 5.44 Gedruckt 11/98