Параллельное и распределенное программирование на С++
Шрифт:
Описание
Функция posix_spawnattr_getflags пре д назначена д ля получения значения атрибута spawn-flags из объекта атрибутов, адресуе м ого пара м етро м attr.
Функция posix_spawnattr_setflags пре д назначена д ля установки значения атрибута spawn-flags в инициализированно м объекте
Атрибут spawn-flags используется д ля обозначения того, какие атрибуты процесса должны быть изменены в образе нового процесса при вызове функции posix_spawn или posix_spawnp. Этот атрибут представляет собой результат применения поразрядной операции включающего ИЛИ к некоторому числу (которое может быть нулевым) следующих флагов:
POSIX_SPAWN_RESETIDS
POSIX_SPAWN_SETPGROUP
POSIX_SPAWN_SETSIGDEF
POSIX_SPAWN_SETSIGMASK
PS
POSIX_SPAWN_SETSCHEDPARAM
POSIX_SPAWN_SETSCHEDULER
Эти флаги определены в заголовке <spawn.h>. Значение, действую щ ее по у м олчанию для этого атрибута, должно соответствовать ситуации, при которой ни один флаг не установлен.
Возвращаемые значения
При успешном выполнении функция posix_spawnattr_getflags возвращает нулевое значение и сохраняет значение атрибута spawn-flags из объекта атрибутов, адресуе м ого пара м етро м attr, в объекте, адресуе м о м пара м етро м flags; в противном случае возвращается код ошибки, обозначающий ее характер.
При успешном выполнении функция posix_spawnattr_setflags возвращает нулевое значение, в противном случае — код ошибки, обозначающий ее характер.
Ошибки
Эти функции м огут завершиться неу д ачно, если: [EINVAL] значение, заданное пара м етро м attr, не д опусти м о.
Функция posix_spawnattr__setflags м ожет завершиться неу д ачно, если:
[ EINVAL ] устанавливаемое значение атрибута недопустимо.
Примеры
Отсутствуют.
Замечания по использованию
Эти функции являются частью опции Spawn и могут быть не пре д ставлены во всех реализациях.
Логическое обоснование
Отсутствует.
Будущие направления
Отсутствуют.
Смотри также
posix_spawn , posix_spawnattr_destroy , posix_spawnattr_init , posix_spawnattr_getsigdefault , posix_spawnattr_getpgroup , posix_spawnattr_getschedparam, posix_spawnattr_getschedpolicy, posix_spawnattr_getsigmask , posix_spawnattr_setsigdefault , posix_spawnattr_setpgroup , posix_spawnattr_setschedparam, posix_spawnattr_setschedpolicy , posix_spawnattr_setsigmask , posix_spawnp ,
Последовательность внесения изменений
Функции впервые реализованы в выпуске Issue 6, основанием послужил стан д арт IEEE Std 1003.1d-1999.
posix_spawnattr_getpgroup, posix_spawnattr_setpgroup
Имя
posix_spawnattr_getpgroup, posix_spawnattr_setpgroup— функции считывания и установки атрибута spawn-pgroup из объекта атрибутов порожденного процесса (ADVANCED REALTIME).
Синопсис
SPN #include <spawn.h>
int posix_spawnattr_getpgroup (
const posix_spawnattr_t *restrict attr,
pid_t *restrict pgroup); int posix_spawnattr_setpgroup (posix_spawnattr_t *attr,
pid_t pgroup) ;
Описание
Функция posix_spawnattr_getpgroup предназначена для получения значения атрибута spawn-pgroup из объекта атрибутов, адресуе м ого пара м етро м attr.
Функция posix_spawnattr_setpgroup позволяет установить атрибут spawn-pgroup в инициализированно м объекте атрибутов, адресуе м о м пара м етро м attr.
Атрибут spawn-pgroup представляет группу процессов, к которой при выполнении операции порождения процесса присоединяется новый процесс (если в атрибуте spawn-flags установлен флаг POSIX_SPAWN_SETPGROUP). По у м олчанию значение этого атрибута равно нулю.
Возвращаемые значения
При успешном выполнении функция posix_spawnattr_getpgroup возвращает нулевое значение и сохраняет значение атрибута spawn-pgroup из объекта атрибутов, адресуемого параметром attr, в объекте, адресуемом параметром pgroup\ в противном случае возвращается код ошибки, обозначающий ее характер.
При успешном выполнении функция posix_spawnattr_setgroup возвращает нулевое значение, в противном случае — код ошибки, обозначаю щ ий ее характер.
Ошибки
Выполнение этих функций м ожет завершиться неудачно, если:
[EINVAL] значение, заданное пара м етро м attr, недопусти м о.
Функция posix_spawnattr_setgroup м ожет завершиться неудачно, если:
[ EINVAL ] устанавливае м ое значение атрибута недопусти м о.
Примеры