posix_spawnattr_getflags, posix_spawnattr_setflags
Имя
posix_spawnattr_getflags, posix_spawnattr_setflags— функции считывания и установки атрибута spawn-flags из объекта атрибутов порож д енного процесса (ADVANCED REALTIME).
Синопсис
SPN #include < spawn.h>
int posix_spawnattr_getflags (const posix_spawnattr_t *restrict attr, short *restrict flags);
int posix_spawnattr_setflags (posix_spawnattr_t *attr, short flags);
Описание
Функция posix_spawnattr_getflags () пре д назначена д ля получения значения атрибута spawn-flags из объекта атрибутов, адресуе м ого пара м етро м attr.
Функция posix_spawnattr_setflags () пре д назначена д ля установки значения атрибута spawn-flags в инициализированно м объекте атрибутов, адресуе м о м пара м етро м аttr.
Атрибут 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 (), том Base Definitions стан д арта IEEE Std 1003.1-2001, <spawn. h>.
Последовательность внесения изменений
Функции впервые реализованы в выпуске 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 ] устанавливае м ое значение атрибута недопусти м о.
Примеры
Отсутствуют.
Замечания по использованию
Эти функции являются частью опции Spawn и могут быть не пре д ставлены во всех реализациях.
Логическое обоснование
Отсутствует.
Будущие направления
Отсутствуют.
Смотри также
posix_spawn(), posix_spawnattr_destroy(),posix_spawnattr_init(), posix_spawnattr_getsigdefault(), posix_spawnattr_getflags(), posix_spawnattr_getschedparam(), posix_spawnattr_getschedpolicy(), posix_spawnattr_getsigmask(), posix_spawnattr_setsigdefault(), posix_spawnattr_setflags (), posix_spawnattr_setschedparam(), posix_spawnattr_setschedpolicy(), posix_spawnattr_setsigmask(), posix_spawnp (), том Base Deflnitions стан д арта IEEE Std 1003.1-2001, <spawn.h>.
Последовательность внесения изменений
Функции впервые реализованы в выпуске Issue 6, основанием послужил стандарт IEEE Std 1003.1d-1999.
posix_spawnattr_getschedparam, posix_spawnattr_setschedparam
Имя
posix_spawnattr_getschedparam, posix_spawnattr_setschedparam
функции считывания и установки атрибута spawn-schedparam из объекта атрибутов порожденного процесса (ADVANCED REALTIME).
Синопсис
SPNPS #include <spawn.h>
#include <sched.h>
int posix_spawnattr_getschedparam (const posix_spawnattr_t *restrict attr, struct sched_param *restrict schedparam) ;
int posix_spawnattr_setschedparam (posix_spawnattr_t *restrict attr, const struct sched_param *restrict schedparam) ;
Описание
Функция posix_spawnattr_getschedparam() предназначена для получения значения атрибута spawn-schedparamn3 объекта атрибутов, адреcуемого параметром attr.
Функция posix_spawnattr_setschedparam() позволяет установить атрибут spawn-schedparam в инициализированно м объекте атрибутов, адресуе м о м пара м етро м аttr.
Атрибут spawn-schedparam представляет пара м етры стратегии планирования, присваивае м ые образу нового процесса при выполнении операции порождения процесса (если в атрибуте spawn-flags установлен флаг POSIX_SPAWN_SETSCHEDULER или флаг POSIX_SPAWN_SETSCHEDPARAM). По у м олчанию значение этого атрибута не задано.
