flockfile(3)

ИМЯ
flockfile, ftrylockfile, funlockfile - блокирует FILE для stdio

LIBRARY
Standard C library (libc, -lc)

СИНТАКСИС
#include <stdio.h>

void flockfile(FILE *filehandle);
int ftrylockfile(FILE *filehandle);
void funlockfile(FILE *filehandle);

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

Все функции, показанные выше:
    /* Since glibc 2.24: */ _POSIX_C_SOURCE >= 199309L
        || /* glibc <= 2.23: */ _POSIX_C_SOURCE
        || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

ОПИСАНИЕ
Функции stdio можно без опаски использовать в нитях. Это достигается назначением каждому объекту FILE счётчика блокировок и (если счётчик не равен нулю) нити-владельца. При каждом библиотечном вызове эти функции ждут разблокировки объекта FILE другой нитью, блокируют его, а затем выполняют заданную операцию ввода/вывода и разблокируют объект.

(Замечание: блокировка не учитывается, если блокировка файла осуществлялась функциями типа flock(2) и lockf(3).)

Всё это прозрачно и незаметно для программиста на С, но всё же есть две причины для более подробного изучения. Первая: возможны последовательности операций ввода/вывода в одной нити, при этом другая нить не будет прерывать ввод/вывод. Вторая: можно избежать чрезмерной нагрузки от блокировок.

С этой целью нить может явно блокировать объект FILE, осуществить серию операций ввода/вывода, а затем снять блокировку. При этом другие нити не могут вклиниться между операциями. Если причиной для реализации всего этого является повышение эффективности работы, то для ввода/вывод можно использовать неблокирующие версии функций stdio: getc_unlocked(3) и putc_unlocked(3) вместо getc(3) и putc(3).

Функция flockfile() ожидает, пока *filehandle не разблокируется другой нитью, затем делает текущую нить владельцем *filehandle и увеличивает счётчик блокировок.

Функция funlockfile() уменьшает счётчик блокировок.

Функция ftrylockfile() является неблокирующей версией flockfile(). Она ничего не делает в том случае, если другая нить владеет *filehandle, в противном случае устанавливает статус владельца и увеличивает счётчик блокировок.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
При успешном выполнении функция ftrylockfile() возвращает ноль (была получена блокировка) или ненулевое значение при ошибках.

ОШИБКИ
Нет.

АТРИБУТЫ
Описание терминов данного раздела смотрите в attributes(7).
Интерфейс | Атрибут | Значение
flockfile(), ftrylockfile(), funlockfile() | Безвредность в нитях | MT-Safe

СТАНДАРТЫ
POSIX.1-2001, POSIX.1-2008.

Эти функции доступны, если определено _POSIX_THREAD_SAFE_FUNCTIONS.

СМ. ТАКЖЕ
unlocked_stdio(3)

ПЕРЕВОД
Русский перевод этой страницы руководства был сделан Azamat Hackimov <azamat.hackimov@gmail.com>, Dmitry Bolkhovskikh <d20052005@yandex.ru>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>

Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 (https://www.gnu.org/licenses/gpl-3.0.html) или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на man-pages-ru-talks@lists.sourceforge.net.