ИМЯ
mkdir − создать каталог
ОБЗОР
#include
<sys/stat.h>
#include <sys/types.h>
int mkdir(const char *pathname, mode_t mode);
ОПИСАНИЕ
mkdir пытается создать каталог, который называется pathname.
mode задает права доступа, которые получит свежесозданный каталог. Эти права стандартным образом модифицируются с помощью umask: права доступа оказываются равны (mode & ~umask).
Свежесозданный каталог принадлежит фактическому владельцу процесса. Если на родительском каталоге установлен флаг setgid, или файловая система смонтирована с семантикой групп в стиле BSD, то новый каталог унаследует группу-владельца от своего родительского каталога; в противном случае группой-владельцем станет фактическая группа процесса.
Если у родительского каталога установлен бит setgid, то он будет установлен также и у свежесозданного каталога.
ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
mkdir возвращает ноль при успешном завершении или −1, если произошла ошибка (в этом случае errno устанавливается должным образом).
ОШИБКИ
|
EPERM |
Файловая система, содержащая pathname, не поддерживает создание каталогов. EEXIST pathname уже существует (это не обязательно каталог). Эта ошибка также возникает, когда pathname является символической ссылкой, висячей или нет. | ||
|
EFAULT |
pathname указывает за пределы доступного адресного пространства. | ||
|
EACCES |
Родительский каталог не позволяет запись, или же один из каталогов, перечисленных в pathname, не позволяет поиск (выполнение). |
ENAMETOOLONG
pathname слишком длинно.
|
ENOENT |
Компонент пути pathname не существует или является висячей символической ссылкой. | ||
|
ENOTDIR |
Компонент пути, использованный как каталог в pathname, в действительности таковым не является. | ||
|
ENOMEM |
Ядру не хватило памяти. | ||
|
EROFS |
Файл находится на файловой системе, смонтированной только для чтения. | ||
|
ELOOP |
pathname является зацикленной символической ссылкой, то есть при подстановке возникает ссылка на неё саму. | ||
|
ENOSPC |
На устройстве, содержащем pathname, нет места для создания новой записи в каталоге. Это может произойти также, если исчерпана квота дискового пространства пользователя. |
СООТВЕТСТВИЕ СТАНДАРТАМ
SVr4, POSIX, BSD, SYSV, X/OPEN. SVr4 документирует дополнительные коды ошибок EIO, EMULTIHOP и ENOLINK; POSIX.1 не упоминает ELOOP.
В протоколе, на котором работает NFS, есть множество недоработок. Некоторые из них влияют на mkdir.
СМОТРИ ТАКЖЕ
mkdir(1), chmod(2), mount(2), rmdir(2), unlink(2)
ПЕРЕВОД
Copyright (C) Alexey Mahotkin <alexm [AT] hsys.ru> 1999-2000