|
Сервер содержит море(!) аналитической информации
|
CIT Forum CD-ROM
|
|
FCNTL(2)
НАЗВАНИЕ
fcntl - управление файлами
СИНТАКСИС
#include <fcntl.h>
int fcntl (fildes, cmd, arg)
int fildes, cmd, arg;
ОПИСАНИЕ
Системный вызов fcntl выполняет управляющие операции
над открытыми файлами. Аргумент fildes - это дескриптор
открытого файла, полученный после выполнения системных
вызовов creat, open, dup, fcntl и pipe.
Аргумент cmd может принимать следующие значения, определяющие выполняемую операцию:
- F_DUPFD
- Создать новый дескриптор файла с такими свойствами:
- Его номер - есть минимальный из доступных номеров, не меньших arg.
- Он ассоциирован с тем же открытым файлом (или
каналом), что и исходный дескриптор fildes.
- У него тот же указатель текущей позиции в файле, что и у исходного (то есть они разделяют
общий указатель).
- Тот же режим доступа к файлу (чтение, запись
или чтение/запись).
- Те же флаги статуса файла (то есть оба дескриптора разделяют общие флаги статуса).
- Ассоциированный с новым дескриптором флаг "закрыть при выполнении вызова exec" устанавливается в состояние "оставить открытым при выполнении вызова exec".
- F_GETFD
- Получить значение флага "закрыть при выполнении
вызова exec" для дескриптора файла fildes. Если
младший бит возвращаемого значения равен нулю, то
файл останется открытым, в противном случае при
выполнении вызова exec файл будет закрыт.
- F_SETFD
- Установить значение флага "закрыть при выполнении
вызова exec" для дескриптора файла fildes равным
значению младшего бита (0 или 1) аргумента arg.
- F_GETFL
- Получить флаги статуса файла, ассоциированного с
дескриптором fildes.
- F_SETFL
- Установить флаги статуса файла, ассоциированного с
дексриптором fildes, равными значению аргумента
arg. Могут быть установлены только некоторые флаги
[см. fcntl(5)].
- F_GETLK
- Получить характеристики первой блокировки, мешающей установить новую блокировку, задаваемую структурой типа flock с адресом arg. Результирующая информация возвращается в той же структуре. Если нет
помех для создания нужной блокировки, то структура
flock не изменяется за исключением поля типа блокировки, которому присваивается значение F_UNLCK.
- F_SETLK
- Установить или снять блокировку сегмента файла в
соответствии со значением структуры типа flock, на
которую указывает аргумент arg. [см. fcntl(5)].
Операция F_SETLK используется для установки блокировки на чтение (F_RDLCK) или запись (F_WRLCK), а
также для снятия блокировки обоих типов (F_UNLCK).
Если блокировка на чтение или запись не может быть
установлена, то системный вызов fcntl завершается
немедленно и возвращает -1.
- F_SETLKW
- Эта операция отличается от операции F_SETLK только
тем, что при неудачной попытке установить блокировку на чтение или запись процесс переходит в
состояние ожидания до тех пор, пока нужный сегмент
файла не будет разблокирован.
Блокировка на чтение предотвращает блокировку защищаемой области каким-либо процессом на запись. Для данного
сегмента файла могут одновременно существовать несколько блокировок на чтение. Дескриптор, используемый для
установления блокировки на чтение, должен быть ассоциирован с файлом, открытым с правом чтения.
Блокировка на запись предотвращает блокировку защищаемой области на чтение или запись. Одновременно может
существовать не более одной блокировки на запись данного сегмента файла. Дескриптор, используемый для установления блокировки на запись, должен быть ассоциирован
с файлом, открытым с правом записи.
Структура типа flock содержит поля, определяющие для
сегмента файла тип блокировки (l_type), начальное смещение (l_whence), относительное смещение (l_start),
размер (l_len), идентификатор системы РУФ (l_sysid),
идентификатор процесса (l_pid). Идентификаторы процесса
и системы используются только в случае операции F_GETLK
для возврата характеристик блокировки. Начало и конец
блокируемой области могут выходить за конец файла, но
не за начало. Можно определить блокировку, всегда действующую до конца файла, если значение поля l_len равно
0. Если значения полей l_whence и l_start равны 0, то
блокировка будет распространяться на весь файл. Изменение или снятие блокировки сегмента из середины большого
защищенного сегмента приводит к появлению с обоих концов двух меньших защищенных сегментов. Блокировка сегмента, который уже блокирован вызывающим процессом,
приводит к удалению старого и установке нового типа
блокировки. Все блокировки, ассоциированные с файлом
для данного процесса, удаляются, когда файл закрывается
этим процессом или когда процесс терминируется, не закрывая файл. Блокировки не наследуются порождаемым процессом при выполнении системного вызова fork(2).
Если блокировка доступа к файлу разрешена [см.
chmod(2)], то системные вызовы read и write для этого
файла выполняются с учетом действующих блокировок.
Системный вызов fcntl завершается неудачей, если выполнено хотя бы одно из следующих условий:
- [EBADF]
- Аргумент fildes не является корректным
дескриптором открытого файла.
- [EINVAL]
- При операции cmd, равной F_DUPFD, значение
аргумента arg либо отрицательно, либо больше или равно максимально допустимому для
одного пользователя количеству дескрипторов
открытых файлов.
- [EINVAL]
- При операции cmd, равной F_GETLK, F_SETLK
или F_SETLKW, значение аргумента arg или
информация, на которую указывает arg, некорректны.
- [EACCES]
- При операции cmd, равной F_SETLK, делается
попытка блокировать на чтение (F_RDLCK)
сегмент файла, заблокированный другим процессом на запись, либо попытка блокировать
на запись (F_WRLCK) сегмент файла, заблокированный другим процессом на чтение или запись.
- [ENOLCK]
- При операции cmd, равной F_SETLK или
F_SETLKW, превышается максимально допустимое системой количество блокировок.
- [EDEADLK]
- При операции cmd, равной F_SETLKW, ожидание
возможности установить блокировку приводит
к тупику.
- [EFAULT]
- При операции cmd, равной F_SETLK, аргумент
arg указывает за пределы отведенного процессу адресного пространства.
- [EINTR]
- Во время выполнения системного вызова перехвачен сигнал.
- [ENOLINK]
- Дескриптор fildes ассоциирован с файлом на
удаленном компьютере, связи с которым в
данный момент нет.
СМ. ТАКЖЕ
close(2), creat(2), dup(2), exec(2), fork(2), open(2),
pipe(2), fcntl(5).
ДИАГНОСТИКА
При успешном завершении системного вызова в зависимости
от операции cmd возвращаются следующие значения:
- F_DUPFD Новый дескриптор файла.
- F_GETFD Значение флага (определен только младший бит).
- F_SETFD Значение, отличное от -1.
- F_GETFL Значение флагов статуса файла.
- F_SETFL Значение, отличное от -1.
- F_GETLK Значение, отличное от -1.
- F_SETLK Значение, отличное от -1.
- F_SETLKW Значение, отличное от -1.
В случае ошибки возвращается -1, а переменной errno
присваивается код ошибки.
ПРЕДОСТЕРЕЖЕНИЯ
Так как в будущем переменной errno будет присваиваться
значение EAGAIN вместо EACCES в случае, если сегмент
файла уже блокирован другим процессом, для достижения
мобильности прикладных программ следует ожидать и обрабатывать оба кода ошибки.
