Параллельное и распределенное программирование на С++
Шрифт:
int pthread_rwlock_timedwrlock (
pthread_rwlock_t *restrict rwlock,
const struct timespec *restrict abs_timeout);
Описание
Функция pthread_rwlock_timedwrlock при м еняет блокировку для обеспечения записи к объекту блокировки чтения-записи, адресуемому пара м етро м rwlock, подобно функции pthread_rwlock_wrlock . Однако, если блокировка не м ожет быть предоставлена без ожидания, пока другие потоки не освободят ее, это ожидание будет прервано, когда истечет заданный
TMR Если поддерживается опция Timers, отсчет интервала вре м ени происходит с использование м часов CLOCK_REALTIME.
Если опция Timers не поддерживается, отсчет интервала времени происходит с использованием системных часов, значение которых возвращает функция time . Разрешение для интервала времени определяется разрешением часов, которые используются для его отсчета. Тип данных timespec определяется в заголовке <time.h>. Ни при каких условиях эта функция не завершится неудачно, если блокировка может быть предоставлена немедленно. В проверке достоверности параметра abs_timeout нет никакой необходимости, если блокировка может быть предоставлена немедленно.
Если потоку, заблокированно м у по объекту блокировки чтения-записи при вызове функции pthread_rwlock_timedwrlock, передается сигнал, то после его обработки поток возобновит ожидание освобождения блокировки, как если бы оно и не прерывалось.
Вызывающий поток может попасть в ловушку взаимоблокировки, если во время вызова он удерживает блокировку чтения-записи по объекту, адресуемому параметро м rwlock. Результаты не опре д елены, если эта функция вызывается с неинициализированны м объекто м блокировки чтения-записи.
Возвращаемое значение
Функция pthread_rwlock_timedwrlock возвра щ ает нулевое значение, если блокировка для записи по объекту блокировки чтения-записи, адресуе м о м у пара м етро м rwloc, предоставлена. В противно м случае возвращается код ошибки, обозначающий ее характер.
Ошибки
Фу н кция pthread_rwlock_timedwrlock завершится неудачно, если:
[ETIMEDOUT] блокировка не м огла быть предоставлена до истечения заданного интервала вре м ени.
Функция pthread_rwlock_timedwrlock м ожет завершиться неудачно, если:
[EDEADLK] вызываю щ ий поток уже удерживает объект блокировки по объекту,
адресуе м о м у пара м етро м rwlock;
[EINVAL] значение,
Эта функция не возвра щ ает код ошибки [EINTR].
Примеры
Отсутствуют.
Замечания по использованию
Как упоминалось в томе Base Definitions стандарта IEEE Std 1003.1-2001 (Section 3.285, Priority Inversion), приложения, которые используют эту функцию, могут подвергнуться инверсии приоритетов.
Функция pthread_rwlock_timedwrlock является частью опций Threads и Timeouts и может быть не предоставлена во всех реализациях.
Логическое обоснование
Отсутствует.
Будущие направления
Отсутствуют.
Смотри также
pthread_rwlock_destroy,pthread_rwlock_rdlock, pthread_rwlock_timedrdlock, pthread_rwlock_tryrdlock, pthread_rwlock_trywrlock , pthread_rwlock_unlock , pthread_rwlock_wrlock , том Base Definitions стандарта IEEE Std 1003.1-2001, <pthread. h>, <t ime. h>.
Последовательность внесения изменений
Функция впервые реализована в выпуске Issue 6, основание м послужил стандарт IEEEStd 1003.1j-2000.
pthread_rwlock_trywrlock, pthread_rwlock_wrlock
Имя
pthread_rwlock_trywrlock, pthread_rwlock_wrlock — функции, блокирующие объект блокировки чтения-записи для обеспечения записи.
Синопсис
THR
#include <pthread.h>
int pthread_rwlock_trywrlock (pthread_rwlock_t *rwlock);
int pthread_rwlock_wrlock (pthread_rwlock_t *rwlock);
Описание
Функция pthread_rwlock_trywrlock при м еняет блокировку для обеспечения записи подобно функции pthread_rwlock_wrlock, за исключением того, что эта функция завершится неудачно, если какой-нибудь поток в данный момент удерживает блокировку по объекту, адресуемому пара м етро м rwlock (для чтения или записи).
Функция pthread_rwlock_wrlock при м еняет блокировку для обеспечения записи к объекту блокировки чтения-записи, адресуе м о м у пара м етро м rwlock. Вызываю щ ий поток получает блокировку для записи, если никакой другой поток (записываю щ ий или считываю щ ий) не удерживает этот объект блокировки. В противно м случае этот поток будет заблокирован до тех пор, пока он не с м ожет получить блокировку. Вызываю щ ий поток м ожет попасть в ловушку взаи м облокировки, если во вре м я вызова он удерживает блокировку чтения-записи (либо для записи, либо для чтения) по объекту, адресуе м о м у пара м етро м rwlock.