Шрифт:
Имя
pthread_mutexattr_getprioceiling, pthread_mutexattr_setprioceiling
Синопсис
THR #include <pthread.h> TPP
int pthread_mutexattr_getprioceiling (
const pthread_mutexattr_t *restrict attr, int *restrict prioceiling); int pthread_mutexattr_setprioceiling (
pthread_mutexattr_t *attr, int prioceiling);
Описание
Функции pthread_mutexattr_getprioceiling и pthread_mute-xattr_setprioceiling используются для считывания и установки соответственно атрибута prioceiling в объекте атрибутов м ьютекса, адресуе м о г о параметром attr, который был ранее создан с помо щ ью функции pthread_mutexattr_init .
Атрибут prioceiling содержит предельное значение приоритета инициализированных мьютексов. Значения атрибута prioceiling ограничены границами диапазона приоритетов, определенного для стратегии планирования, соответствующей значению SCHED_FIFO.
Значение атрибута prioceiling — это минимальный уровень приоритета, на котором еще выполняется критический раздел, защищаемый мьютексом. Чтобы избежать инверсии приоритетов, предельное значение приоритета мьютекса устанавливается выше самого высокого приоритета всех потоков, которые могут блокировать этот мьютекс, или равным ему.
Возвращаемые значения
При успешно м завершении функции pthread_mutexattr_getprioceiling и pthread_mutexattr_setprioceiling возвращают нулевое значение; в противном случае — код ошибки, обозначающий ее характер.
Ошибки
Функции pthread_mutexattr_getprioceiling и pthread_mutexattr_setprioceiling могут завершиться неудачно, если:
[EINVAL] значение, заданное пара м етро м attr, или пара м етро м prioceiling, недействительно;
[EPERM] инициатор вызова не обладает привеле г ия м и для выполнения этой операции.
Эти функции не возвра щ ают код ошибки [EINTR].
pthread_mutexattr_getprioceiling, pthread_mutexattr_setprioceiling — функции считывания и установки атрибута prioceiling в объекте агрибутов м ьютекса (REALTIME THREADS).
Примеры
Отсутствуют.
Замечания по использованию
Отсутствуют.
Логическое обоснование
Отсутствует.
Будущие направления
Отсутствуют.
Смотри также
pthread_cond_destroy, pthread_create, pthread_mutex_destroy, том Base Definitions стандарта1ЕЕЕ Std 1003.1-2001, <pthread.h>.
Последовательность внесения изменений
Функции впервые реализованы в выпуске Issue 5. Включены для со г ласования с расширением POSIX Threads Extension.
Отмечены как часть группы Realtime Threads Feature Group.
Issue 6
Функции pthread_mutexattr_getprioceiling и pthread_mutexattr_setp-rioceiling отмечены как часть опций Threads и Thread Priority Protection.
Код ошибки [ENOSYS] был исключен, поскольку его нет смысла учитывать, если реализация не под д ерживает опцию Thread Priority Protection.
Ко д ошибки [ENOTSUP] был исключен, поскольку эти функции не имеют аргумента protocol.
В целях согласования со стан д артом ISO/IEC 9899: 1999 в прототип функции pthread_mutexattr_getprioceiling было д обавлено ключевое слово restrict.
pthread_mutexattr_setprotocol, pthread_mutexattr_getprotocol
Имя
pthread_mutexattr_setprotocol, pthread_mutexattr_getprotocol
Синопсис
THR #include <pthread.h>