CREAT(2)

НАЗВАНИЕ
creat - создание нового или опустошение существующего файла

СИНТАКСИС


        int creat (path, mode)

        char *path;

        int mode;

ОПИСАНИЕ
Системный вызов creat создает новый обычный файл или готовит для перезаписи существующий файл с маршрутным именем, адрес которого содержит аргумент path.

Если файл существует, то он опустошается (размер становится равным 0), а режим доступа и владелец не изменяются. Если файл не существует, то идентификаторы владельца и группы создаваемого файла устанавливаются равными, соответственно, действующим идентификаторам пользователя и группы процесса, а младшие 12 бит значения режима доступа файла устанавливаются равными значению аргумента mode, модифицированному следующим образом:

  1. Обнуляются биты, соответствующие единичным битам маски режима создания файлов текущего процесса [см. umask(2)].
  2. Бит навязчивости [см. chmod(2)] обнуляется.

В случае успешного завершения системного вызова возвращается дескриптор файла, открытого только на запись, даже если режим доступа к файлу не разрешает запись. Указатель текущей позиции устанавливается на начало файла. Дескриптор файла создается таким, чтобы после выполнения системных вызовов exec(2) файл оставался открытым [см. fcntl(2)]. Процесс может иметь открытыми одновременно не более 20 файлов. Новый файл может быть создан с режимом доступа, запрещающим запись.

Системный вызов creat завершается неудачей, если выполнено хотя бы одно из следующих условий:

[ENOTDIR]
Компонент маршрута не является каталогом.
[ENOENT]
Компонент маршрута не существует.
[EACCES]
Для компонента маршрута отсутствует право на поиск.
[ENOENT]
Маршрутное имя пусто.
[EACCES]
Создание файла требует записи в каталог, права на запись в который нет.
[EROFS]
Файл расположен или должен быть расположен в файловой системе, доступной только на чтение.
[ETXTBSY]
Файл содержит разделяемую секцию команд, которая в данный момент выполняется.
[EACCES]
Файл существует и запись в него запрещена.
[EISDIR]
Файл существует и является каталогом.
[EMFILE]
Превышается максимально допустимое количество файлов, открытых одновременно в одном процессе.
[EFAULT]
Аргумент path указывает за пределы отведенного процессу адресного пространства.
[ENFILE]
Переполнение системной таблицы файлов.
[EAGAIN]
Файл существует и доступ к нему заблокирован [см. chmod(2)].
[EINTR]
Во время выполнения системного вызова перехвачен сигнал.
[ENOLINK]
Маршрутное имя path указывает на удаленный компьютер, связи с которым в данный момент нет.
[EMULTIHOP] Компоненты path требуют многократного обращения к удаленным компьютерам.
[ENOSPC]
Нет свободных описателей файлов.

СМ. ТАКЖЕ
chmod(2), close(2), dup(2), fcntl(2), lseek(2), open(2), read(2), umask(2), write(2).

ДИАГНОСТИКА
При успешном завершении результат равен неотрицательному целому числу - дескриптору файла; в случае ошибки возвращается -1, а переменной errno присваивается код ошибки.