table of contents
other versions
- wheezy 3.44-1
- jessie 3.74-1
- jessie-backports 4.10-2~bpo8+1
- testing 4.10-2
- unstable 4.10-2
other sections
MKDIR(2) | Linux Programmer's Manual | MKDIR(2) |
NAME¶
mkdir - create a directorySYNOPSIS¶
#include <sys/stat.h> #include <sys/types.h>int mkdir(const char *pathname, mode_t mode);
DESCRIPTION¶
mkdir() attempts to create a directory named pathname.RETURN VALUE¶
mkdir() returns zero on success, or -1 if an error occurred (in which case, errno is set appropriately).ERRORS¶
- EACCES
- The parent directory does not allow write permission to the process, or one of the directories in pathname did not allow search permission. (See also path_resolution(7).)
- EEXIST
- pathname already exists (not necessarily as a directory). This includes the case where pathname is a symbolic link, dangling or not.
- EFAULT
- pathname points outside your accessible address space.
- ELOOP
- Too many symbolic links were encountered in resolving pathname.
- EMLINK
- The number of links to the parent directory would exceed LINK_MAX.
- ENAMETOOLONG
- pathname was too long.
- ENOENT
- A directory component in pathname does not exist or is a dangling symbolic link.
- ENOMEM
- Insufficient kernel memory was available.
- ENOSPC
- The device containing pathname has no room for the new directory.
- ENOSPC
- The new directory cannot be created because the user's disk quota is exhausted.
- ENOTDIR
- A component used as a directory in pathname is not, in fact, a directory.
- EPERM
- The file system containing pathname does not support the creation of directories.
- EROFS
- pathname refers to a file on a read-only file system.
CONFORMING TO¶
SVr4, BSD, POSIX.1-2001.NOTES¶
Under Linux apart from the permission bits, only the S_ISVTX mode bit is honored. That is, under Linux the created directory actually gets mode (mode & ~umask & 01777). See also stat(2). There are many infelicities in the protocol underlying NFS. Some of these affect mkdir().SEE ALSO¶
mkdir(1), chmod(2), chown(2), mkdirat(2), mknod(2), mount(2), rmdir(2), stat(2), umask(2), unlink(2), path_resolution(7)COLOPHON¶
This page is part of release 3.44 of the Linux man-pages project. A description of the project, and information about reporting bugs, can be found at http://www.kernel.org/doc/man-pages/.2010-06-26 | Linux |