Параллельное и распределенное программирование на С++
Шрифт:
Будущие направления
Отсутствуют.
Смотри также
close , dup , open , posix_spawn , posix_spawn_file_actions_adddup2 ,
posix_spawn_file_actions_destroy , posix_spawnp , том Base Definitions стандарта IEEE Std 1003.1-2001, < spawn. h>.
Последовательность внесения изменений
Функции впервые реализованы в выпуске Issue 6, основание м послужил стандарт IEEEStd 1003.1d-1999.
При м еняется интерпретация IEEE PASC Interpretation 1003.1 #105, со г ласно которой в раздел «Описание» было внесено дополнение о то м, что строка, адресуе м
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.
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. Результат инициализации уже инициализированно г о объекта действий над файла м и не определен.