MAN mkdir 2

Материал из Gentoo Linux Wiki

Вернуться в раздел мануалов

[править] Имя

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 устанавливается должным образом).

[править] Ошибки

0.8i 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@hsys.msk.ru> 1999-2000

[править] Комментарии к man файлу

Hey Emacs! This file is -*- nroff -*- source.

This manpage is Copyright (C) 1992 Drew Eckhardt;
1993 Michael Haardt
1993,1994 Ian Jackson.
You may distribute it under the terms of the GNU General
Public Licence. It comes with NO WARRANTY.

$Id: mkdir.2.in,v 1.6 2000/09/30 09:43:52 alexm Exp $

Дата последней коррекции перевода 01.01.2004
Оригинальный перевод Алексея Махоткина <alexm@hsys.msk.ru> 1999-2001

.B #include <unistd.h>