PTHREAD_RWLOCKATTR_SETKIND_NP(3)

ИМЯ
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 для блокировки записи. Но смотрите ДЕФЕКТЫ.

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).

ДЕФЕКТЫ
Назначение вида блокировки чтения-записи PTHREAD_RWLOCK_PREFER_WRITER_NP приводит к тому же поведению что и установка значения в PTHREAD_RWLOCK_PREFER_READER_NP. Пока читающая нить удерживает блокировку, нить с блокировкой записи ждёт. Установка вида блокировки PTHREAD_RWLOCK_PREFER_WRITER_NONRECURSIVE_NP позволяет писателям работать, но как видно из имени подразумевается, что писатель не может выполнять рекурсивную блокировку.

СМОТРИТЕ ТАКЖЕ
pthreads(7)