---

   waitid - ожидает смену состояния процесса

---

---

ОПИСАНИЕ

Если состояние потомка уже изменилось, то вызов сразу возвращает результат. В противном случае, работа приостанавливается до тех пор, пока не произойдёт изменение состояния потомка или обработчик сигналов не прервёт вызов (предполагается, что системные вызовы не перезапускаются автоматически из-за указания флага SA_RESTART в sigaction(2)). В оставшейся части страницы потомок, чьё состояние ещё не было получено одним из этих системных вызовов, называется ожидаемым (waitable).

wait() и waitpid()

    waitpid(-1, &status, 0);

Системный вызов waitpid() приостанавливает выполнение вызвавшего процесса до тех пор, пока не изменится состояние потомка, заданного аргументом pid. По умолчанию waitpid() ожидает только прекращения работы потомка, но это можно изменить через аргумент options как описано далее.

Значением pid может быть:

Значение options создаётся путем битовой операции ИЛИ над следующими константами:

WNOHANG означает немедленный возврат, если ни один потомок не завершил выполнение.

WUNTRACED также возвращаться, если есть остановленный потомок (но не трассируемый через ptrace(2)). Состояние трассируемого остановленного потомка предоставляется даже если этот аргумент не указан.

WCONTINUED (начиная с Linux 2.6.10) также возвращаться, если работа остановленного потомка возобновилась из-за получения сигнала SIGCONT.

(Аргументы, имеющиеся только в Linux, см. далее.)

Если status не равен NULL, то wait() и waitpid() сохраняют информацию о состоянии в переменной типа int, на которую указывает status. Это целое можно исследовать с помощью следующих макросов (они принимают в качестве аргумента само целое, а не указатель на него как wait() и waitpid()!):

WIFEXITED(status) возвращает истинное значение, если потомок нормально завершился, то есть вызвал exit(3) или _exit(2), или вернулся из функции main().

WEXITSTATUS(status) возвращает код завершения потомка. Он состоит из восьми младших бит аргумента status, который потомок указал при вызове exit(3) или _exit(2) или в аргументе оператора return в функции main(). Этот макрос можно использовать, только если WIFEXITED вернул истинное значение.

WIFSIGNALED(status) возвращает истинное значение, если потомок завершился из-за сигнала.

WTERMSIG(status) возвращает номер сигнала, который привел к завершению потомка. Этот макрос можно использовать, только если WIFSIGNALED вернул истинное значение.

WCOREDUMP(status) возвращает истинное значение, если потомок создал дамп памяти (core dump). Данный макрос должен использоваться только, если при WIFSIGNALED возвращается истинное значение. Данный макрос не указан в POSIX.1-2001 и недоступен в некоторых реализациях UNIX (например, AIX, SunOS). Используйте его обрамлённым #ifdef WCOREDUMP ... #endif.

WIFSTOPPED(status) возвращает истинное значение, если потомок остановлен по сигналу; это возможно только, если при вызове был указан флаг WUNTRACED или если над потомком выполняется трассировка (см. ptrace(2)).

WSTOPSIG(status) возвращает номер сигнала, из-за которого потомок был остановлен. Этот макрос можно использовать только, если при WIFSTOPPED возвращается истинное значение.

WIFCONTINUED(status) (начиная с Linux 2.6.10) возвращает истинное значение, если потомокпродолжил работу, получив сигнал SIGCONT.

waitid()

Аргументы idtype и id определяют какого(их) потомков ждать:

Ожидаемые изменения состояния потомков задаются следующими флагами в options (объединяются через OR):

WEXITED Ждать завершения потомков.

WSTOPPED Ждать потомков, которые завершатся по получению сигнала.

WCONTINUED Ждать возобновления работы потомков (ранее остановленных) при получении сигнала SIGCONT.

Дополнительно с помощью OR в options могут задаваться следующие флаги:

WNOHANG Как в waitpid().

WNOWAIT Оставить потомка в состоянии ожидания; последующий вызов wait сможет снова получить информацию о состоянии потомка.

При успешном возврате, waitid() заполняет следующие поля в структуре siginfo_t, указываемой из infop:

Если в options указан флаг WNOHANG и нет потомков в ожидаемом состоянии, то waitid() сразу возвращает 0, а состояние структуры siginfo_t, на которую указывает infop, неопределённо. Чтобы отличать этот случай от того, где потомок был в ожидаемом состоянии, обнулите поле si_pid перед вызовом и проверьте ненулевое значение в этом поле после отработки вызова.

---

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

В случае успешного выполнения waitpid() возвращает ID процесса потомка, чьё состояние изменилось; если задан флаг WNOHANG и существует один или более потомков, заданных в pid, без изменённого состояния, то возвращается 0. При ошибке возвращается -1.

Вызов waitid() возвращает 0 в случае успешного выполнения или если задан флаг WNOHANG и пока не существует потомка(ов), указанного в pid,с изменённым состоянием. При ошибке возвращается -1.

Каждый из этих вызовов записывает в errno соответствующую причину ошибки.

---

ОШИБКИ

ECHILD (для wait()) У вызвавшего процесса нет ожидающих потомков.

ECHILD (для waitpid() или waitid()) Процесс, заданный pid (waitpid()) или idtype и id (waitid()), не существует или не является потомком вызвавшего процесса. (Это может случиться для своего потомка, если действие для SIGCHLD установлено в SIG_IGN. См. также раздел Linux Notes о нитях.)

EINTR Флаг WNOHANG не задан и был пойман неблокируемый сигнал или SIGCHLD; см. signal(7).

EINVAL Недопустимое значение options.

---

СООТВЕТСТВИЕ СТАНДАРТАМ

---

ЗАМЕЧАНИЯ

В POSIX.1-2001 указано, что если для SIGCHLD указан флаг SIG_IGN или SA_NOCLDWAIT (смотрите sigaction(2)), то завершающиеся потомки не становятся зомби, а вызов wait() или waitpid() заблокирует выполнение до тех пор, пока все потомки не завершат работу, и затем завершится с ошибкой errno, равной ECHILD (в оригинальном стандарте POSIX такое значение настройки SIGCHLD в SIG_IGN не определено. Заметим, что хотя поведение SIGCHLD по умолчанию является «игнорирование», явная установка в SIG_IGN приводит другому обращению с потомками зомби).

Linux 2.6 соответствует данной спецификации. Однако, Linux 2.4 (и ранее) не соответствует: если вызов wait() или waitpid() сделан при игнорировании SIGCHLD, вызов работает как если бы SIGCHLD не игнорировался, то есть, вызов блокирует работу до тех пор, пока следующий потомок не завершит работу и затем возвращает ID процесса и состояние этого потомка.

Замечания, касающиеся Linux

Следующие значения options, присущие только Linux, используются для потомков, созданных с помощью clone(2); они не могут использоваться с waitid():

__WCLONE Ждать только «клонированных (clone)» потомков. Если не указано, то ожидаются только «не клонированные» потомки («клонированным» считается потомок, который не доставляет сигнал, или сигнал, отличный от SIGCHLD, своему родителю при завершении). Этот аргумент игнорируется, если также указано __WALL.

__WALL (начиная с Linux 2.4) Ждать всех потомков независимо от типа ("клонированный" или "неклонированный").

__WNOTHREAD (начиная с Linux 2.4) Не ждать потомков других нитей в той же группе нитей. Это поведение по умолчанию до Linux 2.4.

Отличия между библиотекой C и ядром

В glibc waitpid() — обёрточная функция, вызывающая wait(2).

Системный вызов ядра waitid() имеет пятый аргумент с типом struct rusage *. Если его значение не равно NULL, то он используется для возврата информации по используемым ресурсам в потомке, в том же виде что и wait4(2). Подробности смотрите в getrusage(2).

ДЕФЕКТЫ

---

ПРИМЕР

Следующий сеанс работы в оболочке показывает работу с программой:

$ ./a.out &
Child PID is 32360
[1] 32359
$ kill -STOP 32360
stopped by signal 19
$ kill -CONT 32360
continued
$ kill -TERM 32360
killed by signal 15
[1]+  Done                    ./a.out
$

Исходный код программы

#include <sys/wait.h>
#include <stdlib.h>
#include <unistd.h>
#include <stdio.h>
int
main(int argc, char *argv[])
{
    pid_t cpid, w;
    int status;
    cpid = fork();
    if (cpid == -1) {
        perror("fork");
        exit(EXIT_FAILURE);
    }
    if (cpid == 0) {            /* Код, выполняемый потомком */
        printf("Child PID is %ld\n", (long) getpid());
        if (argc == 1)
            pause();                    /* Ожидание сигналов */
        _exit(atoi(argv[1]));
    } else {                    /* Код, выполняемый родителем */
        do {
            w = waitpid(cpid, &status, WUNTRACED | WCONTINUED);
            if (w == -1) {
                perror("waitpid");
                exit(EXIT_FAILURE);
            }
            if (WIFEXITED(status)) {
                printf("exited, status=%d\n", WEXITSTATUS(status));
            } else if (WIFSIGNALED(status)) {
                printf("killed by signal %d\n", WTERMSIG(status));
            } else if (WIFSTOPPED(status)) {
                printf("stopped by signal %d\n", WSTOPSIG(status));
            } else if (WIFCONTINUED(status)) {
                printf("continued\n");
            }
        } while (!WIFEXITED(status) && !WIFSIGNALED(status));
        exit(EXIT_SUCCESS);
    }
}