posix_spawn_file_actions_adddup2

Имя

posix_spawn_file_actions_adddup2— функция внесения в объект действий над файла м и действия dup2 (ADVANCED REALTIME).

Синопсис

SPN #include <spawn.h>

int posix_spawn_file_actions_adddup2 (

posix_spawn_file_actions_t * file_aсtions, int fildes, int newfildes);

Описание

Функция posix_spawn_file_actions_adddup2() добавляет в объект, адресуе м ый пара м етро м file_actions, действие dup2(), в результате чего при порождении нового процесса с использование м объекта действий файловый дескриптор fildes дублируется в пара м етр newfildes (как если бы была вызвана функция dup2 ( fildes, newfildes)).

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

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

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

Ошибки

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

[EBADF] значение, заданное пара м етро м fildes или newfildes, отрицательно либо больше или равно значению {0PEN_MAX};

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

Выполнение фу н кции posix_spawn_file_actions_adddup2() м ожет завершиться неудачно, если:

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

Не считается ошибкой, если в качестве значения аргу м ента fildes, передавае м ого функции posix_spawn_file_actions_adddup2(), указан файловый дескриптор, для которо г о заданная операция не м ожет быть выполнена во вре м я вызова. Любая подобная ошибка будет обнаружена, ко г да соответствую щ ий объект действий над файла м и позже будет использован при выполнении функции posix_spawn () или posix_spawnp ().

Примеры

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

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

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

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

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

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

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

Смотри также

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

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

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

При м еняется интерпретация IEEE PASC Interpretation 1003.1 #104, в которой указывается, что ошибка [EBADF], по м и м о аргу м ента fildes, м ожет быть при м ени м а к аргу м енту newfildes.