Параллельное и распределенное программирование на С++ - [238]

етро м 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 (), то м Base Definitions crannapTalEEEStd 1003.1-2001, .

Последовательность внесения изменений

Функции впервые реализованы в выпуске Issue 5. Issue 6

Для согласования со стандарто м IEEE Std 1003.1j-2000 были внесены следую щ ие изменения.

• В разделе «Синопсис» была из м енена м етка. Новая м етка THR означает, что расс м атривае м ые функции теперь являются частью опции Threads (ранее они относились к опции Read-Write Locks стандарта IEEE Std 1003.1j-2000, а также считались частью дополнения XSI).

• Раздел «Описание» был отредактирован следую щ и м образо м:

- заданы условия, при которых записываю щ ие потоки и м еют преи м у щ ество перед считываю щ и м и;

- разъяснена воз м ожная причина неудачного завершения функции pthread_rwlock_tryrdlock();

- добавлен абзац, в которо м говорится о при м енении м акси м ального количество блокировок для обеспечения чтения.

• Был м одифицирован раздел «Ошибки», посвященный описанию кода ошибки [EBUSY] : теперь предлагается принять во внимание приоритет записывающих потоков. Удален абзац, посвященный описанию кода ошибки [EDEADLK] , возвращаемому функцией pthread_rwlock_tryrdlock ().

• Был отредактирован раздел «Смотри также».

Замечания по использованию

Как упо м иналось в то м е Base Definitions стандарта IEEE Std 1003.1-2001 (Se c tion 3.285, Priority Inversion), приложения, которые используют эти функции, м огут подвергнуться инверсии приоритетов.

pthread_rwlock_timedrdlock

Имя

pthread_rwlock_timedrdlock— функция, блокирующал объект блокировки чтения-записи для обеспечения чтения.

Синопсис

THR #include TMO #include

int pthread_rwlock_timedrdlock (

pthread_rwlock_t *restrict rwlock,

const struct timespec *restrict abs_timeout);

Описание

Функция pthread_rwlock_timedrdlock () при м еняет блокировку для обеспечения чтения к объекту блокировки чтения-записи, адресуе м о м у пара м етро м rwlock, подобно функции pthread_rwlock_rdlock (). Однако, если блокировка не может быть предоставлена без ожидания, пока другие потоки не освободят ее, это ожидание будет прервано, когда истечет заданный интервал времени. Интервал времени истекает, когда наступит абсолютное вре м я, заданное пара м етро м abs_timeout (т.е. когда показания вре м ени на используе м ых в систе м е часах станут равны м и или превысят значение abs_timeout), или если абсолютное вре м я, заданное пара м етро м abs_ timeou t, уже наступило в м о м ент вызова.

TMR Если по д держивается опция Timers, отсчет интервала вре м ени происходит с использование м часов CLOCK_REALTIME.

Если опция Timers не поддерживается, отсчет интервала времени происходит с использованием системных часов, значение которых возвращает функция time (). Разрешение для интервала времени определяется разрешением часов, которые используются для его отсчета. Тип данных timespec определяется в заголовке . Ни при каких условиях эта функция не завершится неудачно, если блокировка может быть предоставлена немедленно. В проверке достоверности параметра abs_timeout нет никакой необходи м ости, если блокировка м ожет быть предоставлена не м едленно.

Если потоку, заблокированно м у по объекту блокировки чтения-записи при вызове функции pthread_rwlock_timedrdlock(), передается сигнал, то после его обработки поток возобновит ожидание освобождения блокировки, как если бы оно и не прерывалось.

Вызывающий поток может попасть в ловушку взаимоблокировки, если во время вызова он удерживает блокировку для обеспечения записи по объекту, адресуемому параметром rwlock . Результаты не определены, если эта функция вызывается с неинициализированным объектом блокировки чтения-записи.

Возвращаемое значение

Функция pthread_rwlock_timedrdlock() возвра щ ает нулевое значение, если блокировка для чтения по объекту блокировки чтения-записи, адресуе м о м у пара м етро м rwloc, предоставлена. В противно м случае возвращается код ошибки, обозначающий ее характер.

Ошибки

Функция pthread_rwlock_timedrdlock () завершится неудачно, если:

[ETIMEDOUT] блокировка не м огла быть предоставлена до истечения за д анного интервала вре м ени.

Функция pthread_rwlock_timedrdlock () м ожет завершиться неу д ачно, если:

[EAGAIN]  блокировка д ля чтения не м огла быть пре д оставлена, поскольку

превышено