Open system call linux
Вызов open() используется, чтобы преобразовать путь к файлу в описатель файла (небольшое неотрицательно целое число, которое используется с вызовами read , write и т.п. при последующем вводе-выводе). Если системный вызов завершается успешно, возвращенный файловый описатель является наименьшим описателем, который еще не открыт процессом. В результате этого вызова появляется новый открытый файл, не разделяемый никакими процессами (разделяемые открытые файлы могут возникнуть, когда посылается системный вызов fork (2)). Новый описатель файла будет оставаться открытым при выполнении функции exec (2) (смотри описание fcntl (2)). Указатель устанавливается в начале файла. Параметр flags — это флаги O_RDONLY , O_WRONLY или O_RDWR , открывающие файлы «только для чтения», «только для записи» и для чтения и записи соответственно, которые собрираются с помощью побитовой операции OR из таких значений, как: O_CREAT (если файл не существует, то он будет создан. Владелец (идентификатор пользователя) файла устанавливается в значение эффективного идентификатора пользователя процесса. Группа (идентификатор группы) устанавливается либо в значение эффективного идентификатора группы процесса, либо в значение идентификатора группы родительского каталога (зависит от типа файловой системы, параметров подсоединения (mount) и режима родительского каталога, см. например, параметры подсоединения bsdgroups и sysvgroups файловой системы ext2, как описано в руководстве mount (8)).); O_EXCL (Если он используется совместно с O_CREAT , то при наличии уже созданного файла вызов open завершится с ошибкой. В этом состоянии, при существующей символьной ссылке не обращается внимание, на что она указывает.); O_EXCL (Оно не работает в файловых системах NFS, а в программах, использующих этот флаг для блокировки, возникнет «race condition». Решение для атомарной блокировки файла: создать файл с уникальным именем в той же самой файловой системе (это имя может содержать, например, имя машины и идентификатор процесса), используя link (2), чтобы создать ссылку на файл блокировки. Если link() возвращает значение 0, значит, блокировка была успешной. В противном случае используйте stat (2), чтобы убедиться, что количество ссылок на уникальный файл возросло до двух. Это также означает, что блокировка была успешной); O_NOCTTY (если pathname указывает на терминальное устройство — см. tty (4) —, то оно не станет терминалом управления процесса, даже если процесс такового не имеет); O_TRUNC (если файл уже существует, он является обычным файлом и режим позволяет записывать в этот файл (т.е. установлено O_RDWR или O_WRONLY), то его длина будет урезана до нуля. Если файл является каналом FIFO или терминальным устройством, то этот флаг игнорируется. Иначе действие флага O_TRUNC не определено. O_APPEND (Файл открывается в режиме добавления. Перед каждой операцией write файловый указатель будет устанавливаться в конце файла, как если бы использовался lseek ); O_APPEND (может привести к повреждению файлов в системе NFS, если несколько процессов одновременно добавляют данные в один файл. Это происходит из-за того, что NFS не поддерживает добавление в файл данных, поэтому ядро на машине-клиенте должно эмулировать эту поддержку); O_NONBLOCK или O_NDELAY (если возможно, то файл открывается в режиме non-blocking. Ни open , ни другие последующие операции над возвращаемым описателем файла не заставляют вызывающий процесс ждать. Для работы с каналами FIFO см. fifo (4). Этот режим не оказывает никакого действия на не-FIFO файлы.); O_SYNC (Файл открывается в режиме синхронного ввода-вывода. Все вызовы write для соответствующего описателя файла блокируют вызывающий процесс до тех пор, пока данные не будут физически записаны. Однако, Вам необходимо прочитать раздел ОГРАНИЧЕНИЯ); O_NOFOLLOW (если pathname — это символьная ссылка, то open содержит код ошибки. Это расширение FreeBSD, которое было добавлено в Linux версии 2.1.126. Все прочие символьные ссылки в имени будут обработаны как обычно. Заголовочные файлы из glibc версии 2.0.100 (и более поздних) содержат определение этого флага; ядра версий, более ранних, чем 2.1.126, игнорируют этот флаг ); O_DIRECTORY (Если pathname не является каталогом, то open укажет на ошибку. Этот флаг используется только в Linux и был добавлен к ядру 2.1.126, чтобы избежать проблем с «отказом от обслуживания», если opendir (2) был вызван для канала FIFO или ленточного устройства. Этот флаг не следует использовать вне реализации opendir ); O_LARGEFILE (На 32-битных системах, поддерживающих файловые системы (Large), этот флаг позволяет открывать файлы, длина которых больше 31-ого бита.
Некоторые из вышеописанных флагов могут быть изменены с помощью fctnl после открытия файла. Аргумент mode задает права доступа, которые используются в случае создания нового файла. Они модифицируются обычным способом, с помощью umask процесса; права доступа созданного файла равны (mode & ~umask) . Обратите внимание, что этот режим применяется только к правам создаваемого файла; open создает файл только для чтения, но может вернуть дескриптор с установленными флагами для чтения и записи.
Следующие символьные константы можно использовать в mode : S_IRWXU (00700 пользователь (владелец файла) имеет права на чтение, запись и выполнение
файла); S_IRUSR (S_IREAD) (00400 пользователь имеет права на чтение файла); S_IWUSR (S_IWRITE) (00200 пользователь имеет права на запись информации в файл); S_IXUSR (S_IEXEC) (00100 пользователь имеет права на выполнение файла); S_IRWXG (00070 группа имеет права на чтение, выполнение файла и запись в него информации); S_IRGRP (00040 группа имеет права на чтение файла); S_IWGRP (00020 группа имеет права на запись информации в файл); S_IXGRP (00010 группа имеет права на выполнение
файла); S_IRWXO (00007 все остальные имеют права на чтение, выполнение файла и запись в него информации); S_IROTH (00004 все остальные имеют права на чтение файла); S_IWOTH (00002 все остальные имеют права на запись информации в файл); S_IXOTH (00001 все остальные имеют права на выполнение
файла).
mode всегда должен быть указан при использовании O_CREAT ; во всех остальных случаях этот параметр игнорируется. creat эквивалентен open с flags , которые равны O_CREAT | O_WRONLY | O_TRUNC .
ВОЗВРАЩАЕМЫЕ ЗНАЧЕНИЯ
open и creat возвращают новый описатель файла или -1 в случае ошибки (в этом случае
значение переменной errno устанавливается должным образом). Заметьте, что open может открывать файлы устройств, но creat не может создавать их, поэтому используйте для создания функцию mknod (2).
В файловых системах NFS, в которых идентификаторы пользователей могут быть преобразованы, open может вернуть файловый описатель, но, например, read (2) вернет ошибку EACCES из-за того, что клиент выполняет команду open , проверяя права доступа (а преобразование идентификаторов производится сервером при запросах на чтение и запись).
Если создается файл, то его время последнего доступа, создания и модификации устанавливаются в значение текущего времени, а также устанавливаются поля времени модификации и создания родительского каталога. Иначе, если файл изменяется с флагом O_TRUNC, то его время создания и время изменения устанавливаются в значение текущего времени.
НАЙДЕННЫЕ ОШИБКИ
EEXIST pathname уже существует, но были использованы O_CREAT и O_EXCL . EISDIR Тип доступа подразумевает запись, а pathname указывает на каталог, (то есть установлены O_WRONLY или O_RDWR ). EACCES Запрошенный доступ к файлу не разрешен, или один из каталогов в pathname не позволяет поиск (выполнение) файла, файл еще не существует, или доступ для записи в родительский каталог не разрешен. ENAMETOOLONG pathname является слишком длинным. ENOENT O_CREAT не установлен, а указанный файл не существует. Или не существует каталог в пути pathname , или он является неверной символьной ссылкой. ENOTDIR Компонент, который обозначен как каталог в pathname , таковым не является, или был указан флаг O_DIRECTORY , а pathname не является каталогом. ENXIO Установлены O_NONBLOCK | O_WRONLY, файл является каналом FIFO, но нет процессов, которые открыли этот канал для чтения. Возможно также, что файл является файлом устройства, но соответствующее устройство не установлено. ENODEV pathname ссылается на файл устройства, но соответствующего устройства не существует. (Это ошибка в ядре Linux: должен возвращаться параметр ENXIO). EROFS Был запрошен доступ к записи, а pathname ссылается на файл, находящийся в системе, предназначенной только для чтения. ETXTBSY pathname ссылается на файл, который в настоящее время исполняется, и был запрошен доступ к записи. EFAULT pathname указывает на каталог за пределами доступного адресного пространства. ELOOP Слишком много символьных ссылок составляют pathname , или был указан флаг O_NOFOLLOW , а pathname является символьной ссылкой. ENOSPC pathname должен был указать на устройство, в котором отсутствует место для нового файла. ENOMEM Недостаточно памяти в системе. EMFILE Процесс уже открыл максимально допустимое количество файлов. ENFILE Достигнут предел общего количества файлов, открытых в системе.
СООТВЕТСТВИЕ СТАНДАРТАМ
SVr4, SVID, POSIX, X/OPEN, BSD 4.3. Флаги O_NOFOLLOW и O_DIRECTORY являются специфичными для системы Linux. Они могут опреляться макросом _GNU_SOURCE .
Эффект (неопределенный изначально) от O_RDONLY | O_TRUNC отличается в разных реализациях. Во многих системах файл в действительности обрезается.
Флаг O_DIRECT был представлен в SGI IRIX, где он имеет похожие ограничения по принаджености, как и в Linux. IRIX также имеет вызов fcntl(2) для очередей с выравниванием и размерами. FreeBSD 4.x имеет флаг с таким же именем, но без ограничений на выравнивание. В Linux была добавлена поддержка с ядра версии 2.4.10. Старые ядра Linux просто игнорируют этот флаг.
НАЙДЕННЫЕ ОШИБКИ
«Меня всего беспокоило кое-что относительно O_DIRECT — то, что вообще в целом этот интерфейс просто идиотичен. Создается впечатление, что он как-бы был создан сумасшедшей обезьяной для работы с высокими материями, управляющими разумом.» — Linus
НАЙДЕННЫЕ ОШИБКИ И ОГРАНИЧЕНИЯ
В протоколе, по которому работает NFS, существует множество недоработок, оказывающих влияние на O_SYNC и O_NDELAY . POSIX предоставляет три разных варианта синхронного ввода-вывода, соответствующего флагам O_SYNC , O_DSYNC и O_RSYNC . В настоящее время (версия 2.1.130) все флаги являются похожими на флаги Linux.