Читаем Linux API. Исчерпывающее руководство полностью

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

• WNOHANG — если ни один из потомков, указанных в pid, все еще не изменил свое состояние, вызов немедленно возвращается, не переходя к блокированию (то есть «опрашивает» потомков). В этом случае возвращаемое значение waitpid() равно 0. Если у родителя не оказывается дочерних процессов, соответствующих значению pid, waitpid() возвращает ошибку ECHILD.

Использование waitpid() проиллюстрировано в листинге 26.3.

В обосновании внесения вызова waitpid() в стандарт SUSv3 отмечается, что название флага WUNTRACED берет свое начало в системе BSD, где выполнение процесса может остановиться по одной из двух причин: из-за отслеживания системным вызовом ptrace() или в результате получения сигнала (то есть без отслеживания). Когда потомок отслеживается вызовом ptrace(), любой полученный им сигнал (кроме SIGKILL) приводит к его остановке и последующей отправке его родителю сигнала SIGCHLD. Так происходит даже в том случае, если потомок игнорирует сигналы. Однако, если сигналы заблокированы, то работа процесса не останавливается (это относится ко всем сигналам, кроме неблокирующегося SIGSTOP).

26.1.3. Статус ожидания

Значение status, возвращаемое вызовами wait() и waitpid(), позволяет различать следующие события, касающиеся потомков.

• Потомок завершил работу с помощью вызова _exit() (или exit()), вернув целочисленный код выхода.

• Потомок был завершен путем доставки необработанного сигнала.

• Потомок был остановлен сигналом, а вызов waitpid() был произведен с использованием флага WUNTRACED.

• Потомок возобновил работу после сигнала SIGCONT, а вызов waitpid() был выполнен с использованием флага WCONTINUED.

Чтобы охватить все случаи, приведенные выше, мы будем обращаться к термину «статус ожидания». Первые два пункта можно назвать кодом завершения (чтобы получить его для последней программы, выполненной в командной строке, можно прочитать содержимое переменной $?).

И хотя значение status является целым числом, только последних два байта из него действительно используются. Способ их заполнения зависит от того, какое из перечисленных выше событий произошло с потомком (рис. 26.1).

На рис. 26.1 показана схема статуса ожидания в Linux/x86-32. Детали могут отличаться в зависимости от реализации. SUSv3 не предусматривает определенной компоновки для этой информации; он даже не требует, чтобы статус ожидания хранился именно в последних двух байтах, на которые указывает status. Для чтения этих данных в переносимых приложениях всегда нужно использовать макросы из этого раздела, избегая прямого доступа к элементам битовой маски.

Заголовочный файл определяет стандартный набор макросов, с помощью которых можно анализировать код завершения. Только один из них вернет true, если применить его к значению status, возвращаемому вызовами wait() и waitpid(). Как отмечено в списке, для более глубокого анализа предоставляются дополнительные макросы.

Рис. 26.1.Значение, возвращаемое вызовами wait() и waitpid() в аргументе status

• WIFEXITED(status) — возвращает true, если дочерний процесс завершился штатно. В этом случае макрос WEXITSTATUS(status) возвращает код завершения дочернего процесса (как было отмечено в разделе 25.1, родителю доступен только младший байт код завершения).

• WIFSIGNALED(status) — возвращает true, если дочерний процесс был завершен с помощью сигнала. В этом случае макрос WTERMSIG(status) возвращает номер сигнала, приведшего к завершению процесса, а макрос WCOREDUMP(status) возвращает true, если потомок сгенерировал файл с дампом памяти. WCOREDUMP(status) не входит в стандарт SUSv3, но доступен в большинстве реализаций UNIX.

• WIFSTOPPED(status) — возвращает true, если дочерний процесс был остановлен по сигналу. В этом случае макрос WSTOPSIG(status) возвращает номер сигнала, остановившего процесс.

• IFCONTINUED(status) — возвращает true, если дочерний процесс возобновил свою работу, получив сигнал SIGCONT. Он доступен в системе Linux, начиная с версии 2.6.10.

Обратите внимание, что, хотя вышеприведенные макросы тоже используют для своих аргументов имя status, они ожидают получить обычное целое число, а не указатель на него, как в случае с вызовами wait() и waitpi().

Пример программы

Функция printWaitStatus() из листинга 26.2 задействует все макросы, перечисленные выше. Она считывает и выводит содержимое статуса ожидания.