wait3(3)                (BSD Compatibility Package)                wait3(3)

NAME
     wait3 - Warten, bis der Prozeß beendet oder gestoppt wird

SYNTAX
     /usr/ucb/cc [flag ...] file ... -lucb

     #include <sys/wait.h>

     pidt wait3(int *statloc, int options, struct rusage *resourceusage);

BESCHREIBUNG
     Über die Funktion wait3 kann der aufrufende Prozeß Statusinformationen
     zu bestimmten Sohnprozessen erhalten.

     Der folgende Aufruf:

          wait3(statloc, options, resourceusage);

     entspricht dem Aufruf:

          waitpid((pidt)-1, statloc, options);

     mit der Ausnahme, daß bei erfolgreicher Ausführung die Struktur
     rusage, auf die das dritte Argument zeigt, für den Sohnprozeß ausge-
     füllt wird, der durch den Return-Wert angegeben ist (sofern das Argu-
     ment resourceusage für wait3 kein Nullzeiger ist).

RÜCKGABEWERT
     Wenn wait3() zurückkehrt, weil der Status eines Sohnprozesses verfüg-
     bar ist, gibt es einen Wert zurück, der der Prozeß-ID des Sohnprozes-
     ses entspricht, für den der Status zurückgegeben wurde. Kehrt wait3()
     aufgrund der Auslieferung eines Signals an den aufrufenden Prozeß
     zurück, wird -1 zurückgegeben und errno auf EINTR gesetzt. Wird
     waitpid() mit gesetztem Flag WNOHANG im Argument options aufgerufen,
     ist zumindest ein durch pid angegebener Sohnprozeß vorhanden, für den
     kein Status verfügbar ist; wenn für keinen der durch pid angegebenen
     Prozesse ein Status verfügbar ist, wird 0 zurückgegeben. Andernfalls
     wird (pidt)-1 zurückgegeben und errno zur Anzeige des Fehlers
     gesetzt.

DIAGNOSE
     Neben den unter waitpid(2) angegebenen Fehlerbedingungen kann wait3
     auch unter folgenden Bedingungen fehlschlagen, wobei errno auf den
     genannten Wert gesetzt wird:

     ECHILD    Der aufrufende Prozeß hat keine vorhandenen Sohnprozesse,
               auf die nicht gewartet wird, oder die durch das Argument pid
               angegebenen Prozesse können niemals die durch das Argument
               options angegebenen Statuswerte annehmen.

SIEHE AUCH
     exec(2), exit(2), fork(2), pause(2), waitpid(2), wait(5).



Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98