pid_t pgroup
— группа дочернего процесса; имеет смысл, только если установлен флаг
SPAWN_SETGROUP
. Если флаг
SPAWN_SETGROUP
установлен и
inherit.pgroup
установлен как
SPAWN_NEWPGROUP
, то дочерний процесс открывает новую группу процессов с идентификатором группы (GID), равным PID этого нового процесса.
sigset_t sigmask
— сигнальная маска дочернего процесса, если установлен флаг
SPAWN_SETSIGMASK
.
sigset_t sigdefault
— набор сигналов дочернего процесса, для которых определяется реакция по умолчанию, если установлен флаг
SPAWN_SETSIGDEF
.
uint32_t nd
— это совершенно уникальный (относительно других ОС, а значит, и всего POSIX) параметр QNX - дескриптор узла сети QNET, на котором должен быть запущен новый процесс. Это поле используется, только если установлен флаг
SPAWN_SETND
.
argv
— указатель массива аргументов. Значение
argv[0]
должно быть строкой (
char*
), содержащей имя файла, загружаемого как процесс (но может быть
NULL
, если аргументы не передаются). Последний элемент массива
argv
обязан быть
NULL
. Само значение
argv
никогда не может быть
NULL
.
envp
— указатель массива символьных строк переменных системного окружения (environment). Последний элемент массива
envp
обязан быть
NULL
. Каждый элемент массива является строкой (
char*
) вида: variable = value. Если само значение указателя
envp
равно
NULL
, то дочерний процесс полностью наследует копию окружения родителя. (Окружение процесса — всегда «копия», поэтому любые изменения, внесенные в окружение дочерним процессом, никак не отражаются на окружении его родителя.)
Если дочерний процесс является скриптом интерпретатора (флаг
SPAWN_CHECK_SCRIPT
), то первая строка текста скрипта должна начинаться с
#!
, за которыми должны следовать путь и аргументы того интерпретатора, который будет использоваться для интерпретации этого скрипта. К скрипту не применяется установленный в системе интерпретатор по умолчанию (как это происходит при вызове его по имени из командной строки).
Правила наследования (и ненаследования) параметров дочернего процесса от родителя (RID, RGID и других атрибутов) жестко регламентированы, достаточно сложны (в зависимости от флагов) и могут быть уточнены в технической документации QNX. Отметим, что безусловно наследуются такие параметры, как: а) приоритет и дисциплина диспетчеризации; б) рабочий и корневой каталоги файловой системы. Не наследуются: установки таймеров процесса
tms_utime
,
tms_stime
,
tms_cutime
и
tms_cstime
, значение взведенного сигнала
SIGALRM
(это значение сбрасывается в ноль), файловые блокировки, блокировки и отображения памяти (shared memory), установленные родителем.
При успешном завершении вызов функции возвращает PID порожденного процесса. При неудаче возвращается -1 и
errno
устанавливается:
•
E2BIG
— количество байт, заданное в списке аргументов или переменных окружения и превышающее
ARG_MAX
;
•
EACCESS
— нет права поиска в каталогах префикса имени файла, или для файла не установлены права на выполнение, или файловая система по указанному пути была смонтирована с флагом
ST_NOEXEC
;
•
EAGAIN
— недостаточно системных ресурсов для порождения процесса;
•
ERADF
— недопустим хотя бы один из файловых дескрипторов в массиве
fd_map
;
•
EFAULT
— недопустима одна из буферных областей, указанных в вызове;
•
ELOOP
— слишком глубокий уровень символических ссылок к файлу или глубина префиксов (каталогов) в полном пути к файлу;
•
EMFILE
— недостаточно ресурсов для отображения файловых дескрипторов в дочерний процесс;
•
ENAMETOOLONG
— длина полного пути превышает
PATH_MAX
или длина компонента имени файла и пути превышает
NAME_MAX
;
•
ENOENT
— файл нулевой длины или несуществующий префиксный компонент в полном пути;
•
ENOEXEC
— файл, указанный как программа, имеет ошибочный для исполняемого файла формат;
•
ENOMEM
— в системе недостаточно свободной памяти для порождения процесса;
•
ENOSYS
— файловая система, специфицированная полным путевым именем файла, не предназначена для выполнения
spawn()
;
•
ENOTDIR
— префиксные компоненты пути исполняемого файла не являются каталогами;
Даже из этого очень краткого обзора вызова
spawn()
становятся очевидными некоторые вещи:
• Эта форма универсальна (самодостаточна), она позволяет обеспечить весь спектр разнообразных форм порождения нового процесса