MKDIR(2)

НАЗВАНИЕ
mkdir - создание каталога

СИНТАКСИС


        int mkdir (path, mode)

        char *path;

        int mode;

ОПИСАНИЕ
Функция mkdir создает новый каталог с именем path. Аргумент mode задает режим доступа к новому каталогу. Соответствующая процессу маска режима создания файлов модифицирует биты защиты аргумента mode [см. umask(2)].

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

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

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

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