ИМЯ

pthread_rwlockattr_setkind_np, pthread_rwlockattr_getkind_np - изменяет/возвращает вид блокировки чтения-записи у объекта-атрибута блокировки чтения-записи нити

ОБЗОР

#include <pthread.h>

int pthread_rwlockattr_setkind_np(pthread_rwlockattr_t *attr,
                                   int pref);
int pthread_rwlockattr_getkind_np(const pthread_rwlockattr_t *attr,
                                   int *pref);

Компилируется и компонуется вместе с -pthread.

Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):

pthread_rwlockattr_setkind_np(), pthread_rwlockattr_getkind_np():

_XOPEN_SOURCE >= 500 || _POSIX_C_SOURCE >= 200809L

ОПИСАНИЕ

Функция pthread_rwlockattr_setkind_np() изменяет атрибут «вида блокировки» у объекта-атрибута блокировки чтения-записи, на который указывает attr, в значение pref. Значением pref может быть одно из:

PTHREAD_RWLOCK_PREFER_READER_NP: Значение по умолчанию. Нить может удерживать многократную блокировку чтения; то есть блокировки чтения рекурсивны. Согласно Single Unix Specification, поведение не определено, если читатель пытается установить блокировку и отсутствует блокировка записи, но писатели ждут. Давая преимущество читателю установкой PTHREAD_RWLOCK_PREFER_READER_NP подразумевается, что читатель будет получать запрашиваемую блокировку даже, если ждёт писатель. Пока есть читатели писатель будет ждать.
PTHREAD_RWLOCK_PREFER_WRITER_NP: Аналог PTHREAD_RWLOCK_PREFER_READER_NP, но для блокировки записи. Игнорируется glibc, так как с учётом требований POSIX рекурсивная блокировка записи, привела был к созданию вечной блокировки (deadlocks); вместо неё используется PTHREAD_RWLOCK_PREFER_WRITER_NONRECURSIVE_NP, которая не позволяет разработчику приложения получить рекурсивную блокировку чтения, и поэтому вечной блокировки не случится.
PTHREAD_RWLOCK_PREFER_WRITER_NONRECURSIVE_NP: Данный вид блокировки помогает избежать ожидания писателя всё время пока не освободится рекурсивная блокировка чтения.

Функция pthread_rwlockattr_getkind_np() сохраняет атрибут «вида блокировки» у объекта-атрибута блокировки чтения-записи, на который указывает attr, в указатель pref.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

При успешном выполнении эти функции возвращают 0. При корректных аргументах указателей pthread_rwlockattr_getkind_np() всегда выполняется успешно. При ошибке pthread_rwlockattr_setkind_np() возвращает ненулевой номер ошибки.

ОШИБКИ

EINVAL: Неподдерживаемое значение pref.

ВЕРСИИ

Функции pthread_rwlockattr_getkind_np() и pthread_rwlockattr_setkind_np() впервые появились в glibc 2.1.

СООТВЕТСТВИЕ СТАНДАРТАМ

Данные функции являются не стандартизированными расширениями GNU, о чем свидетельствует суффикс «_np» (nonportable).

СМОТРИТЕ ТАКЖЕ

pthreads(7)

pthread_rwlockattr_setkind_np(3)