sigwait(3-thr) sigwait(3-thr)
NAME
sigwait - Einen Thread veranlassen, auf ein asynchrones Signal zu war-
ten
SYNTAX
#include <pthread.h>
int sigwait(sigsett *set);
PARAMETER
set Menge der unbearbeiteten Signale, auf die der aufrufende
Thread wartet.
BESCHREIBUNG
Diese Routine veranlaßt den Thread, auf ein asynchrones Signal zu war-
ten. Dabei wird ein unbearbeitetes Signal aus set eindeutig ausge-
wählt, es wird eindeutig aus den unbearbeiteten Signalen des Systems
gelöscht, und die Nummer dieses Signals wird zurückgegeben. Wenn kein
Signal aus set zur Zeit des Aufrufs unbearbeitet ist, wird der Thread
so lange blockiert, bis ein oder mehrere Signale auf Verarbeitung war-
ten. Die durch set definierten Signale können beim Aufruf dieser Rou-
tine blockiert sein und werden blockiert, wenn der Thread vom Aufruf
zurückkehrt, sofern momentan kein anderer Thread auf eines dieser Sig-
nale wartet.
Zur Verwendung der Funktion sigprocmask() muß ein Thread die Signale,
auf die er wartet, vor dem Aufruf dieser Funktion blockieren.
Wenn diese Routine von mehreren Threads verwendet wird, um auf das-
selbe Signal zu warten, kehrt nur einer dieser Threads von dieser Rou-
tine mit der Signalnummer zurück.
Ein Aufruf von sigwait() ist ein Abbruchpunkt.
RÜCKGABEWERTE
Mögliche Rückgabewerte sind:
EINVAL Einer oder mehrere der durch set angegebenen Werte ist
ungültig.
EINVAL Eines oder mehrere der durch set angegebenen Signale ist
nicht blockiert.
EINVAL In set sind keine Werte angegeben.
SIEHE AUCH
pause(2), sigpending(2), sigprocmask(2), pthreadcancel(3-thr),
pthreadsetasynccancel(3-thr), sigsetops(3C), signal(5).
Seite 1 Reliant UNIX 5.44 Gedruckt 11/98