pthread_mutex_t *restrict mutex, int prioceiling, int *restrict old_ceiling) ;
Описание
Функция pthread_mutex_getprioceiling() используется для считывания теку щ его значения предельного приоритета м ьютекса. Функция pthread_mutex_setprioceiling() сначала блокирует м ьютекс, если он разблокирован, или надежно удерживает его в заблокированно м состоянии, а зате м изменяет значение предельного приоритета мьютекса и после этого освобождает его. При успешном изменении приоритета его предыдущее значение возвращается с помощью параметра old__ceiling. В процессе блокирования мьютекса нет необходимости привязываться к протоколу за щ иты приоритета.
При неудачном выполнении функции pthread_mutex_setprioceiling() предельное значение приоритета мьютекса не будет изменено.
Возвращаемые значения
При успешном завершении функции pthread_mutex_getprioceiling() и pthread_mutex_setprioceiling() возвращают нулевое значение; в противном случае — код ошибки, обозначающий ее характер.
Ошибки
Функции pthread_mutex_getprioceiling () и pthread_mutex_setprioceiling () могут завершиться неудачно, если:
[EINVAL] приоритет, заданный пара м етро м prioceiling, не попадает в нужный диапазон:
[EINVAL] значение, заданное пара м етро м mutex, не относится ни к одно м у из существующих мьютексов;
[ EPERM] инициатор вызова не и м еет привиле г ий д л я выпо л нения этой операции.
Эти функции не возвра щ ают код ошибки [EINTR].
Примеры
Отсутствуют.
Замечания по использованию
Отсутствуют.
Логическое обоснование
Отсутствует.
Будущие направления
Отсутствуют.
Смотри также
pthread_mutex_destroy(),pthread_mutex_lock(),
pthread_mutex_timedlock (), то м Base Definitions стандарта IEEE Std 1003.1-2001, .
Последовательность внесения изменений
Функции впервые реализованы в выпуске Issue 5. Включены для согласования с расширением POSIX Threads Extension.
Отмечены как часть группы Realtime Threads Feature Group.
Issue 6
Функции pthread_mutex_getprioceiling () и pthread_mutex_setprioceiling () отмечены как часть опций Threads и Thread Execution Scheduling.
Код ошибки [ENOSYS] был исключен, поскольку его нет смысла учитывать, если реализация не поддерживает опцию Thread Priority Protection.
Код ошибки [ENOSYS], обозначающий отсутствие поддержки протокола учета приоритета для мьютексов, был исключен. Дело в том, что если реализация предоставляет эти функции (независимо от того, определено ли значение _POSIX_PTHREAD_PRIO_PROTECT), они должны работать так, как отмечено в разделе «Описание», т.е. протокол учета приоритета для мьютексов должен поддерживаться.