Ubuntu Manpage: wait, waitpid - oczekiwanie na zakończenie procesu

nazwa
składnia
opis
wartość zwracana
błędy
uwagi
uwagi linuksowe
zgodne z
zobacz także
informacje o tłumaczeniu

NAZWA

       wait, waitpid - oczekiwanie na zakończenie procesu

SKŁADNIA

       #include <sys/types.h>
       #include <sys/wait.h>

       pid_t wait(int *status);
       pid_t waitpid(pid_t pid, int *status, int options);

OPIS

Uwaga! To tłumaczenie może być nieaktualne!

Funkcja wait zatrzymuje wykonywanie bieżącego procesu aż do zakończenia procesu potomka lub aż do
dostarczenia sygnału kończącego bieżący proces lub innego, dla którego wywoływana jest funkcja obsługi
sygnału. Jeśli potomek zakończył działanie przed wywołaniem tej funkcji (tak zwany proces-duch -
"zombie"), to funkcja kończy się natychmiast. Wszelkie zasoby potomka są zwalniane.

Funkcja waitpid zawiesza wykonywanie bieżącego procesu dopóki potomek określony przez pid nie zakończy
działania lub dopóki nie zostanie dostarczony sygnał, którego akcją jest zakończenie procesu lub
wywołanie funkcji obsługującej sygnały. Jeśli potomek, podany jako pid, zakończył swoje działanie przed
wywołaniem tej funkcji (tak zwany proces "zombie"), funkcja kończy się natychmiast. Wszelkie zasoby
potomka są zwalnianie.

Wartość pid może być:

< -1 co oznacza oczekiwanie na dowolny proces potomny, którego ID grupy procesów jest równy wartości
bezwzględnej pid.

-1 co oznacza oczekiwanie na dowolny proces potomny; jest to takie samo zachowanie, jakie wykazuje
wait.

0 co oznacza oczekiwanie na każdy proces potomny, którego ID grupy procesu jest równe ID grupy
procesu wywołującego funkcję.

> 0 oznacza oczekiwanie na potomka, którego ID procesu jest równy wartości pid.

Wartość options jest sumą OR zera lub więcej spośród następujących stałych:

WNOHANG
oznacza natychmiastowy powrót z funkcji, jeśli potomek nie zakończył pracy.

WUNTRACED
oznacza zakończenie także dla zatrzymanych (ale nie śledzonych) procesów potomnych, których stan
jeszcze nie został zgłoszony. Stan śledzonych procesów potomnych, które zostały zatrzymane, jest
udostępniany również bez tej opcji.

(Poniższe opcje dotyczą wyłącznie Linuksa.)

Jeśli status nie jest równe NULL, wait lub waitpid zapisuje dane o stanie w buforze wskazywanym przez
status.

Stan ten można zanalizować następującymi makrami (makra te pobierają jako argument bufor stat (typu int),
— nie wskaźnik do bufora!):

WIFEXITED(status)
jest niezerowe, jeśli potomek normalnie zakończył pracę.

WEXITSTATUS(status)
analizuje osiem najmniej znaczących bitów kodu powrotu zakończonego potomka, które mogły być
ustawione jako argument wywołania exit() lub jako argument instrukcji return w programie głównym.
Makro to może być przetworzone, tylko jeśli WIFEXITED zwróciło wartość niezerową.

WIFSIGNALED(status)
zwraca prawdę, jeśli proces potomny zakończył pracę z powodu nieprzechwyconego sygnału.

WTERMSIG(status)
zwraca numer sygnału, który spowodował zakończenie procesu potomnego. Makro to może być
przetworzone, tylko jeśli WIFSIGNALED zwróciło wartość niezerową.

WIFSTOPPED(status)
zwraca prawdę, jeśli proces potomny jest obecnie zatrzymany; jest to możliwe tylko gdy w wywołaniu
użyto WUNTRACED oraz gdy proces potomny jest śledzony (zobacz ptrace(2)).

WSTOPSIG(status)
zwraca numer sygnału, który spowodował zatrzymanie potomka. Makro to może być przetworzone, tylko
jeśli WIFSTOPPED zwróciło wartość niezerową.

Niektóre wersje Uniksa (np. Linux, Solaris, ale nie AIX, SunOS) definiują także makro WCOREDUMP(status)
sprawdzające, czy proces potomny dokonał zrzutu pamięci. Należy go używać tylko pomiędzy dyrektywami
kompilatora #ifdef WCOREDUMP ... #endif.

WARTOŚĆ ZWRACANA

       PID zakończonego potomka lub zero, jeśli użyto WNOHANG, a nie było dostępnego żadnego potomka, albo -1  w
       przypadku błędu (w tym ostatnim wypadku odpowiednia wartość jest nadawana errno).

BŁĘDY

       ECHILD jeśli  proces o zadanym pid nie istnieje lub nie jest potomkiem procesu wywołującego. (Może się to
              zdarzyć również w przypadku potomka, który ustawił  akcję  obsługi  sygnału  SIGCHLD  na  SIG_IGN.
              Zobacz także: wątki w sekcji UWAGI LINUKSOWE.)

       EINVAL jeśli argument options jest niepoprawny.

       EINTR  jeśli WNOHANG nie było ustawione, a został przechwycony niezablokowany sygnał lub SIGCHLD.

UWAGI

       Specyfikacja  Single Unix Specification opisuje znacznik SA_NOCLDWAIT (nieobsługiwany pod Linuksem) taki,
       że jeżeli jest ustawiony ten znacznik albo akcja dla  SIGCHLD  jest  ustawiona  na  SIG_IGN,  to  procesy
       potomne  po  zakończeniu  nie  stają  się  procesami-duchami  ("zombies")  i wywołanie funkcji wait() lub
       waitpid() zablokuje proces do czasu, gdy  wszystkie  procesy  potomne  zakończą  działanie,  a  następnie
       zakończy się błędem z errno ustawionym na ECHILD.

       Oryginalny  standard  POSIX  nie określa zachowania w przypadku ustawienia SIGCHLD na SIG_IGN. Późniejsze
       standardy, włączając SUSv2 i POSIX 1003.1-2001 określają zachowanie w sposób taki, jaki opisano  w  opcji
       zgodności  z  XSI.  Linux  nie  spełnia tego drugiego w dwóch opisanych powyżej punktach: jeśli wywołanie
       wait() lub waitpid() jest wykonywane z ignorowaniem SIGCHLD, zachowuje się ono  tak,  jakby  SIGCHLD  nie
       były  ignorowane,  to  znaczy,  wywołanie zostaje zablokowane do chwili zakończenia następnego potomka, a
       następnie zwraca PID i kod powrotu tego potomka.

UWAGI LINUKSOWE

Pod Linuksem, wątek zarządzany przez jądro nie jest uruchamiany inaczej niż zwykły proces. Zamiast tego
wątek jest po prostu procesem stworzonym przez wywołanie dostępnej tylko pod Linuksem funkcji systemowej
clone(2). Inne funkcje, jak na przykład przenośne pthread_create(3) są zaimplementowane przez wywołania
funkcji clone(2). W wersjach Linuksa poprzedzających 2.4, wątek był po prostu specyficznym przypadkiem
procesu. W związku z tym nie mógł on czekać na potomków innego wątku nawet w przypadku, gdy ten drugi
wątek należał do tej samej grupy wątków. Jednakże, POSIX zaleca taką funkcjonalność, więc począwszy od
Linuksa 2.4 wątek może (i domyślnie będzie) czekać na potomków innych wątków należących do tej samej
grupy wątków.

Następujące, specyficzne dla Linuksa opcje w options są przeznaczone dla potomków utworzonych za pomocą
clone(2).

__WCLONE
Oczekiwanie tylko na potomków typu "clone". Jeśli opcja ta zostanie pominięta będzie oczekiwanie
tylko na potomków typu "nie-clone". (Potomek typu "clone" to taki, który po zakończeniu nie
dostarcza swojemu procesowi macierzystemu sygnału lub dostarcza sygnał inny niż SIGCHLD.) Opcja
ta jest ignorowana, jeśli ustawiona jest również opcja __WALL.

__WALL (Począwszy od Linuksa 2.4) Oczekiwanie na procesy potomne niezależnie od ich typu ("clone" lub
"non-clone").

__WNOTHREAD
(Począwszy od Linuksa 2.4) Nie oczekiwać na procesy potomne innych wątków w obrębie tej samej
grupy wątków. Było to w Linuksie domyślne przed wersją 2.4.

ZGODNE Z

       SVr4, POSIX.1

ZOBACZ TAKŻE

       clone(2), ptrace(2), signal(2), wait4(2), pthread_create(3), signal(7)

INFORMACJE O TŁUMACZENIU

       Powyższe tłumaczenie pochodzi z nieistniejącego już Projektu Tłumaczenia Manuali i może nie być aktualne.
       W razie zauważenia różnic między powyższym opisem a rzeczywistym  zachowaniem  opisywanego  programu  lub
       funkcji, prosimy o zapoznanie się z oryginalną (angielską) wersją strony podręcznika za pomocą polecenia:

              man --locale=C 2 wait

       Prosimy   o   pomoc   w   aktualizacji   stron   man  -  więcej  informacji  można  znaleźć  pod  adresem
       http://sourceforge.net/projects/manpages-pl/.