posix_spawn_file_actions_destroy, posix_spawn_file_actions_init

Имя

posix_spawn_file_actions_destroy, posix_spawn_file_actions_init — функции разрушения и инициализации объекта действий над файла м и для порожде н но г о процесса (ADVANCED REALTIME).

Синопсис

SPN #include <spawn.h>

int posix_spawn_file_actions_destroy (posix_spawn_file_actions_t *file___actions) ;

int posix_spawn_file_actions_init (posix_spawn_file_actions_t *file_actions);

Описание

Функция posix_spawn_file_actions_destroy() предназначена для разрушения объекта, адресуе м о г о пара м етро м file_actions; после ее при м енения объект становится неинициализированны м. В конкретной реализации функция posix_spawn_file_actions_destroy() м ожет устанавливать объект, адресуе м ый пара м етро м file_actions, равны м недействительно м у значению. Разрушенный объект действий над файла м и м ожно снова инициализировать с по м о щ ью функции posix_spawn_file_actions_init(); результаты ссылки на этот объект после е г о разрушения не определены.

Функция posix_spawn_file_actions_init () используется для инициализации объекта, адресуемого параметром file_actions; после ее при м енения объект не будет содержать никаких действий, предназначенных для выполнения над файла м и при вызове функций posix_spawn () или posix_spawnp ().

Объект действий над файла м и порожденно г о процесса определяется в описании функции posix_spawn_file_actions_addclose(). Результат инициализации уже инициализированно г о объекта действий над файла м и не определен.

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

При успешно м завершении эти функции возвра щ ают нулевое значение; в противно м случае — код ошибки, обозначаю щ ий ее характер.

Ошибки

Функция posix_spawn_file_actions_init () завершится неудачно, если:

[EN0MEM]  для и ниц и ализаци и объекта действий над файла м и недостаточно су щ ествую щ ей па м яти.

Функция posix_spawn_file_actions_destroy() м ожет завершиться неудачно, если:

[EINVAL]

значение, заданное пара м етро м file_actions, недопусти м о.

Примеры

Отсутствуют.

Замечания по использованию

Эти функции являются частью опции Spawn и м огут быть не представлены во всех реализациях.

Логическое обоснование

С м отрите раздел «Логическое обоснование» в описании функции posix_spawn_file_actions_addclose().

Будущие направления

Отсутствуют.

Смотри также

posix_spawn (), posix_spawnp (), том Base Definitions стандарта IEEE Std 1003.1-2001, <spawn.h>.

Последовательность внесения изменений

Функции впервые реализованы в выпуске Issue 6, основание м послужил стандарт IEEE Std 1003.1d-1999.

В разделе «Синопсис» включение заголовка <sys/types.h> больше не требуется.