Параллельное и распределенное программирование на С++

Хьюз Камерон

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

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

posix_spawnattr_getsigmask, posix_spawnattr_setsigmask

Имя

posix_spawnattr_getsigmask, posix_spawnattr_setsigmask— функции считывания и установки атрибута spawn-sigmask из объекта атрибутов порожденного процесса (ADVANCED REALTIME).

Синопсис

SPN #include <signal.h>

#include <spawn.h>

int posix_spawnattr_getsigmask (

const posix_spawnattr_t *restrict attr, sigset_t *restrict sigmask); int posix_spawnattr_setsigmask (

posix_spawnattr_t *restrict attr, const sigset_t *restrict sigmask);

Описание

Функция posix_spawnattr_getsigmask

предназначена для получения значения атрибута spawn-sigmask объекта атрибутов, адресуе м ого пара м етро м attr.

Функция posix_spawnattr_setsigmask позволяет установить атрибут spawn-sigmask в инициализированном объекте атрибутов, адресуемом параметром attr .

Атрибут spawn-sigmask представляет м аску сигналов, предназначен н ую для использования в образе нового процесса при выполнении операции порождения процесса (если в атрибуте spawn-flags установлен флаг POSIX_SPAWN_SETSIGMASK). По у м олчанию значение этого атрибута не определено.

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

При успешно м выполнении функция posix_spawnattr_getsigmask возвращает нулевое значение и сохраняет значение атрибута spawn-sigmask из объекта атрибутов, адресуе м ого пара м етро м attr, в объекте, адресуе м о м пара м етро м sigmask; в противно м случае возвращается код ошибки, обозначающий ее характер.

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

Ошибки

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

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

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

[EINVAL ] устанавливаемое значение атрибута недопустимо.

Примеры

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

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

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

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

Отсутствует.

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

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

Смотри также

posix_spawn , posix_spawnattr_destroy , posix_spawnattr_init , posix_spawnattr_getsigdefault, posix_spawnattr_getflags, posix_spawnattr_getpgroup , posix_spawnattr_getschedparam, posix_spawnattr_getschedpolicy, posix_spawnattr_setsigdefault, posix_spawnattr_setflags , posix_spawnattr_setpgroup , posix_spawnattr_setschedparam, posix_spawnattr_setschedpolicy, posix_spawnp ,

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

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

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

pthread_attr_destroy, pthread_attr_init

Имя

pthread_attr_destroy, pthread_attr_init — функции разрушения и инициализации объекта атрибутов потока.

Синопсис

THR #include <pthread.h>

int pthread_attr_destroy (pthread_attr_t *attr); int pthread_attr_init (pthread_attr_t *attr);

Описание

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

Функция pthread_attr_init позволяет инициализировать объект атрибутов потока, адресуемый параметром attr, значением, действующим по умолчанию для всех отдельных атрибутов, используемых в данной реализации.

Результирующий объект атрибутов (воз м ожно, м одифицированный путе м установки значений отдельных атрибутов) при выполнении функции pthread_create определяет атрибуты создавае м о г о потока. В нескольких одновре м енных вызовах функции pthread_create м ожно использовать один объект атрибутов. Результат вызова функции pthread_attr_init не определен, если заданный пара м етро м attr объект атрибутов уже инициализирован.

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

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

Ошибки

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

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

Эти функции не возвращают код ошибки в виде значения [EINTR].