The OpenNET Project / Index page

[ новости /+++ | форум | wiki | теги | ]

Интерактивная система просмотра системных руководств (man-ов)

 ТемаНаборКатегория 
 
 [Cписок руководств | Печать]

open ()
  • open (1) ( Linux man: Команды и прикладные программы пользовательского уровня )
  • open (2) ( Solaris man: Системные вызовы )
  • open (2) ( FreeBSD man: Системные вызовы )
  • >> open (2) ( Русские man: Системные вызовы )
  • open (2) ( Linux man: Системные вызовы )
  • open (3) ( Solaris man: Библиотечные вызовы )
  • open (3) ( Linux man: Библиотечные вызовы )
  • open (3) ( POSIX man: Библиотечные вызовы )
  • open (9) ( Solaris man: Ядро )
  •  

    НАЗВАНИЕ

    open, creat - открывают и, по возможности, создают файл или устройство  

    СИНТАКСИС

    #include <sys/types.h>
    #include <sys/stat.h>
    #include <fcntl.h>
    
    int open(const char *pathname, int flags);
    int open(const char *pathname, int flags, mode_t mode);
    int creat(const char *pathname, mode_t mode);
    
     

    ОПИСАНИЕ

    Вызов 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.  

    СМ. ТАКЖЕ

    read(2), write(2), fcntl(2), close(2), link(2), mknod(2), mount(2), stat(2), umask(2), unlink(2), socket(2), fopen(3), fifo(4)


     

    Index

    НАЗВАНИЕ
    СИНТАКСИС
    ОПИСАНИЕ
    ВОЗВРАЩАЕМЫЕ ЗНАЧЕНИЯ
    НАЙДЕННЫЕ ОШИБКИ
    СООТВЕТСТВИЕ СТАНДАРТАМ
    НАЙДЕННЫЕ ОШИБКИ
    НАЙДЕННЫЕ ОШИБКИ И ОГРАНИЧЕНИЯ
    СМ. ТАКЖЕ


    Поиск по тексту MAN-ов: 




    Спонсоры:
    MIRhosting
    Inferno Solutions
    Hosting by Ihor
    Хостинг:

    Закладки на сайте
    Проследить за страницей
    Created 1996-2019 by Maxim Chirkov
    Добавить, Поддержать, Вебмастеру