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 присваивается код ошибки.