Отсутствует.
Будущие направления
Отсутствуют.
Смотри также
posix_spawn (), posix_spawnattr_destroy (), posix_spawnattr_init (), posix_spawnattr_getflags (), posix_spawnattr_getpgroup (), posix_spawnattr_getschedparam(), posix_spawnattr_getschedpolicy (), posix_spawnattr_getsigmask (), posix_spawnattr_setflags (), posix_spawnattr_setpgroup (), posix_spawnattr_setschedparam(), posix_spawnattr_setschedpolicy(), posix_spawnattr_setsigmask (), posix_spawnp (), том Base Definidons стандарта IEEE Std 1003.1-2001, <signal. h>, <spawn.h>.
Последовательность внесения изменений
Функции впервые реализованы в выпуске 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].
Примеры
Отсутствуют.
Замечания по использованию
Отсутствует.
Логическое обоснование
Объекты атрибутов используются для потоков, мьютексов и условных переменных в качестве будущего механизма поддержки стандартизации в этих областях, не требующего изменения самих функций.
Объекты атрибутов обеспечивают четкую автономность реконфигурируемых аспектов потоков. Например, важным атрибутом потока является «размер стека», который при переносе многопоточной программы с одного компьютера на другой часто приходится корректировать. Использование объектов атрибутов позволит вносить необходимые изменения в одном месте программы, а не в разных местах, «разбросанных» по всем экземплярам потоков.
Объекты атрибутов можно использовать для создания классов потоков с аналогичными атрибутами; например, «потоков с большими стеками и высоким приоритетом» или «потоков с минимальными стеками». Эти классы можно определить в одном месте программы, а затем их использовать, когда понадобится создать поток. В результате значительно упростится процесс изменения «классовых» решений потоков, и не придется подробно анализировать каждый вызов функции pthread_create ().
Объекты атрибутов с целью потенциальной расширяемости определяются как «закрытые» типы. Если бы они были определены как «прозрачные» структуры, то при добавлении новых атрибутов (т.е. при расширении объектов атрибутов) пришлось бы перекомпилировать все многопоточные программы, что не всегда возможно, например, если различные программные компоненты приобретены у различных изготовителей.
Кроме того, «непрозрачные» объекты атрибутов предоставляют возможность для повышения быстродействия. Достоверность атрибутов можно проверить один раз при их установке, а не при каждом создании потока. Ведь реализации зачастую требуют кэширования объектов ядра, создание которых считается «дорогим удовольствием». Именно «непрозрачные» объекты атрибутов позволяют вовремя определить, в какой момент кэшированные объекты становятся недействительными из-за изменения атрибутов.
