posix_spawnattr_destroy()

Уничтожить объект атрибутов порожденного процесса

Прототип:

#include <posix_spawnattr.h>
int posix_spawnattr_destroy( posix_spawnattr_t *attrp );

Аргументы:

attrp
Функция posix_spawnattr_destroy() уничтожает объект атрибутов порожденного процесса attrp со значением по умолчанию для всех отдельных атрибутов, используемых реализацией. Объект атрибутов порождения процесса имеет тип posix_spawnattr_t (определен в <spawn.h>) и используется для указания наследования атрибутов процесса в операции порождения процесса. IEEE Std 1003.1-2001 не определяет операторы сравнения или присваивания для типа posix_spawnattr_t.

Библиотека:

libc

Описание:

Функция posix_spawnattr_destroy() уничтожает объект атрибутов порожденного процесса. Вы можете повторно инициализировать уничтоженный объект атрибутов attrp, используя posix_spawnattr_init(); результаты обращения к объекту после его уничтожения не определены. Используемая реализация может привести к тому, что posix_spawnattr_destroy() установит для объекта, на который ссылается attrp, недопустимое значение. Функция posix_spawnattr_init() инициализирует объект атрибутов порожденного процесса attrp со значением по умолчанию для всех отдельных атрибутов, используемых реализацией. Результаты не определены, если posix_spawnattr_init() вызывается с указанием уже инициализированного объекта атрибутов attrp.

Объект атрибутов порожденного процесса имеет тип posix_spawnattr_t (определен в <spawn.h>) и определяет наследование атрибутов процесса в операции порождения. IEEE Std 1003.1-2001 не определяет операторы сравнения или присваивания для типа posix_spawnattr_t. Каждая реализация документирует используемые ею отдельные атрибуты и их значения по умолчанию, если только эти значения не определены стандартом IEEE Std 1003.1-2001. Атрибуты, не определенные стандартом IEEE Std 1003.1-2001, их значения по умолчанию и имена функций, связанные с get() и set(), определяются реализацией.

Результирующий объект атрибутов порождененного процесса (возможно, измененный путем установки значений отдельных атрибутов) используется для изменения поведения posix_spawn() или posix_spawnp(). После того, как объект атрибутов был использован для порождения процесса вызовом posix_spawn() или posix_spawnp(), любая функция, влияющая на объект атрибутов (включая уничтожение), не влияет ни на один процесс, который был порожден этим способом.


Note: Функция posix_spawnattr_destroy() делает posix_spawnattr_t непригодным для последующего использования. Перед повторным использованием объекта его необходимо инициализировать с помощью posix_spawnattr_init(), что включает в себя вызов posix_spawnattr_destroy() для уже уничтоженного объекта. POSIX устанавливает, что при использовании объекта posix_spawnattr_t после его уничтожения получаются неопределенные результаты. Если вы попытаетесь сослаться на уничтоженный объект атрибутов, все операции get() и set(), а также posix_spawn() вернут EINVAL.

Возвращаемое значение:

EINVAL
Значение, указанное в параметре attrp, недопустимо.
EOK
Успешное завершение.

Классификация:

POSIX 1003.1 RTS

Точка остановки потока
Нет
Обработчик прерываний
Да
Обработчик сигналов
Да
В потоке
Да

Тематические ссылки:

posix_spawn(), posix_spawn_file_actions_addclose(), posix_spawn_file_actions_adddup2(), posix_spawn_file_actions_addopen(), posix_spawn_file_actions_destroy(), posix_spawn_file_actions_init(), posix_spawnattr_addpartid(), posix_spawnattr_addpartition(), posix_spawnattr_getcred(), posix_spawnattr_getflags(), posix_spawnattr_getnode(), posix_spawnattr_getpartid(), posix_spawnattr_getpgroup(), posix_spawnattr_getrunmask(), posix_spawnattr_getschedparam(), posix_spawnattr_getschedpolicy(), posix_spawnattr_getsigdefault(), posix_spawnattr_getsigignore(), posix_spawnattr_getsigmask(), posix_spawnattr_getstackmax(), posix_spawnattr_getxflags(), posix_spawnattr_init(), posix_spawnattr_setcred(), posix_spawnattr_setflags(), posix_spawnattr_setnode(), posix_spawnattr_setpgroup(), posix_spawnattr_setschedparam(), posix_spawnattr_setrunmask(), posix_spawnattr_setschedpolicy(), posix_spawnattr_setsigdefault(), posix_spawnattr_setsigignore(), posix_spawnattr_setsigmask(), posix_spawnattr_setstackmax(), posix_spawnattr_setxflags(), posix_spawnp()




Предыдущий раздел: Описание API системной библиотеки