MAN flock 2
Материал из Gentoo Linux Wiki
- Вернуться в раздел мануалов
Содержание |
[править] Имя
flock - установить или снять advisory блокировку на открытый файл
[править] Обзор
#include <sys/file.h>
int flock(int fd , int operation );
[править] Описание
Устанавливает или снимает advisory (мягкую, носящую рекомендательный характер) блокировку на открытый файл, заданный файловым дескриптором fd . Параметр operation может принимать одно из следующих значений:
1.0i LOCK_SH Установить разделяемую блокировку. Разделяемую блокировку на заданный файл может держать более чем один процесс.
LOCK_EX Установить эксклюзивную блокировку. Только один процесс может держать эксклюзивную блокировку файла.
LOCK_UN
Удалить существующую блокировку, удерживаемую данным процессом.
Вызов flock () может быть блокирован, если несовместимый тип блокировки уже удерживается другим процессом. Чтобы выполнить неблокирующий запрос, включите LOCK_NB (через OR ing) вместе с одной из вышеописаных операций.
Один файл не может иметь одновременно и общую и эксклюзивную блокировку.
Блокировки, созданные flock () ассоциируются с файлом или, более точно, с записью в таблице открытых файлов. Это означает, что дублирующие файловые дескрипторы (созданные, например, вызоывами fork (2) или dup (2)) указывают на ту же самую блокировку и эта блокировка может быть изменена или снята при использовании любого из этих дескрипторов. Таким образом, блокировка освобождается либо через явное выполнение операции LOCK_UN на одном из дублирующих дескрипторов, либо когда все такие дескрипторы будут закрыты.
Процесс может только держать на файле один из типов блокировки (разделяемую или экслюзивную). Последующие вызовы flock () на уже заблокированный файл будут преобразовывать текущую блокировку к новому заданному режиму блокировки.
Блокировки, созданные flock () сохраняются при выполнении execve (2). Разделяемая или эксклюзивная блокировка может быть установлена на файл вне зависимости от режима, в котором этот файл был открыт.
[править] Возвращаемое значение
В случае успеха, возвращается ноль. В случае ошибки возвращается -1 и значение errno устанавливается соответствующим образом.
[править] Ошибки
EWOULDBLOCK Файл блокирован и был выбран флаг LOCK_NB . EBADF fd не является дескриптором открытого файла.
EINTR Во время ожидания установки блокировки, вызов был прерван сигналом, пришедшим в обработчик.
EINVAL Неправильно задано значение operation . ENOLCK Ядру не хватило памяти для создания записи блокировки.
[править] Соответствие стандартам
4.4BSD (вызов flock (2) появился сперва в 4.2BSD). В большинстве Unix'ов flock (2), может быть реализован в терминах fcntl (2) .
[править] Замечания
flock (2) не блокирует файлы на NFS. Используйте вместо этого вызов fcntl (2), который работает на NFS, а также наиболее свежую версию Linux и сервер, который поддерживает блокировки.
Начиная с версии ядра 2.0, flock (2) реализован как системный вызов со своими собственными правами, а не как эмуляция этого вызова в библиотеке GNU C через использование fcntl (2). По смыслу BSD: не существует никакого взаимодействия между типами блокировок, устанавливаемыми flock (2), fcntl (2), и flock (2) не видит блокировок типа deadlock.
flock (2) устанавливает только advisory блокировки; имеющий соотвествующие права на файл, какой-либо процесс может игнорировать использование flock (2) и выполнять над файлом операции ввода/вывода.
flock (2) и блокировки fcntl (2) имеют разный смысл для ожидающих разветвления (fork) процессов и dup (2).
[править] Смотрите также
open (2), close (2), dup (2), execve (2), fcntl (2), fork (2), lockf (3) В /usr/src/linux/Documentation также есть файлы locks.txt и mandatory.txt .
[править] Перевод
Перевёл с английского Виктор Вислобоков <corochoone@perm.ru> 2003
[править] Комментарии к man файлу
Hey Emacs! This file is -*- nroff -*- source.
Copyright 1993 Rickard E. Faith (faith@cs.unc.edu)
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
preserved on all copies.
Permission is granted to copy and distribute modified versions of this
manual under the conditions for verbatim copying, provided that the
entire resulting derived work is distributed under the terms of a
permission notice identical to this one
Since the Linux kernel and libraries are constantly changing, this
manual page may be incorrect or out-of-date. The author(s) assume no
responsibility for errors or omissions, or for damages resulting from
the use of the information contained herein. The author(s) may not
have taken the same level of care in the production of this manual,
which is licensed free of charge, as they might when working
professionally.
Formatted or processed versions of this manual, if unaccompanied by
the source, must acknowledge the copyright and authors of this work.
Modified Fri Jan 31 16:26:07 1997 by Eric S. Raymond <esr@thyrsus.com> and
2002 Michael Kerrisk
Modified 24 Apr 2002 by Michael Kerrisk <mtk16@ext.cannterbury.ac.nz>
Substantial rewrites and additions
Дата последней коррекции перевода 01.01.2004
Перевод с английского сделал Виктор Вислобоков <corochoone@perm.ru>
http://www.linuxshare.ru/projects/trans/mans.html
