Unix Man (Справочное руководство)

MKDIR(2)


MKDIR(2)

НАЗВАНИЕ


mkdir - создание каталога

СИНТАКСИС

int mkdir (path, mode) char *path; int mode;

ОПИСАНИЕ


Функция mkdir создает новый каталог с именем path. Аргумент mode задает режим доступа к новому каталогу. Соответствующая процессу маска режима создания файлов модифицирует биты защиты аргумента mode [см. ].

Идентификатор владельца каталога устанавливается равным действующему идентификатору пользователя, а идентификатор группы устанавливается равным действующему идентификатору группы процесса. Вновь созданный каталог не содержит элементов, за исключением "." и "..".

Функция mkdir завершается неудачей и каталог не создается, если выполнено хотя бы одно из следующих условий:

[ENOTDIR] Компонент маршрута не является каталогом. [ENOENT] Компонент маршрута не существует. [ENOLINK] Аргумент path указывает на удаленный компьютер, связи с которым в данный момент нет. [EMULTIHOP] Компоненты path требуют многократного обращения к удаленным компьютерам. [EACCES] Нет права на поиск для компонента маршрута, либо нет права на запись в каталог, содержащий каталог, который должен быть создан. [ENOENT] Длина маршрута превышает максимально допустимую. [EEXIST] Указанный файл уже существует. [EROFS] Каталог, определенный маршрутом, находится в файловой системе, доступной только на чтение. [EFAULT] Аргумент path указывает за пределы отведенного процессу адресного пространства. [EMLINK] Выполнение системного вызова привело бы к превышению максимального числа ссылок на надкаталог. [EIO] Во время доступа к файловой системе произошла ошибка ввода/вывода.

ДИАГНОСТИКА


При успешном завершении результат равен 0; в случае ошибки возвращается -1, а переменной errno присваивается код ошибки.



Содержание раздела