Максимальное количество одновременных (и гарантированно успешных) блокировок для чтения, которое может быть применено к объекту блокировки чтения-записи, определяется конкретной реализацией. В случае превышения этого максимума функция pthread_rwlock_rdlock () может завершиться неудачно.
Функция pthread_rwlock_tryrdlock() при м еняет блокировку для обеспечения чтения подобно функции pthread_rwlock_rdlock(), за исключение м того, что эта функция завершится неудачно, если эквивалентный вызов функции pthread_rwlock_rdlock() заблокировал вызывающий поток. Ни в каких случаях функция pthread_rwlock_tryrdlock() не блокирует потоки; она всегда либо добивается блокировки, либо немедленно завершается с неудачным результатом.
Результаты выполнения этих функций не определены, если любая из них вызывается с неинициализированным объектом блокировки чтения-записи. Если потоку, ожидающему освобождения блокировки чтения-записи для обеспечения блокировки чтения передается сигнал, то после его обработки поток возобновит ожидание освобождения блокировки, как если бы оно и не прерывалось.
Возвращаемые значения
При успешном завершении функция pthread_rwlock_rdlock() возвращает нулевое значение; в противном случае — код ошибки, обозначающий ее характер.
Функция pthread_rwlock_tryrdlock () возвращает нулевое значение, если блокировка для чтения по объекту блокировки чтения-записи, адресуемому параметром rwloc, предоставлена. В противном случае возвращается код ошибки, обозначающий ее характер.
Ошибки
Функция pthread_rwlock_tryrdlock () завершится неудачно, если:
[EBUSY] блокировка чтения-записи не могла быть предоставлена для чтения, поскольку удерживает блокировку записывающий поток, или по этому объекту заблокирован записывающий поток с соответствующим приоритетом .
Функции pthread_rwlock_rdlock() и pthread_rwlock_tryrdlock() м огут завершиться неудачно, если:
[EINVAL] значение, заданное пара м етро м rwlock, не относится к инициализированно м у объекту блокировки чтения-записи;
[EAGAIN] блокировка не м огла быть предоставлена для чтения, поскольку превышено м акси м альное число блокировок чтения по объекту, адресуе м о м у пара м етро м rwlock.
Функция pthread_rwlock_rdlock () м ожет завершиться неудачно, если:
[EDEADLK] теку щ ий поток уже удерживает объект блокировки чтения-записи для обеспечения записи. Эти функции не возвра щ ают код ошибки [EINTR].
Примеры
Отсутствуют.
Логическое обоснование
Отсутствует.
Будущие направления
Отсутствуют.
Смотри также
pthread_rwlock_destroy (), pthread_rwlock_timedrdlock (), pthread_rwlock_timedwrlock (), pthread_rwlock_trywrlock (), pthread_rwlock_unlock (), pthread_rwlock_wrlock (), то