|MKDIR(2)||Linux Programmer's Manual||MKDIR(2)|
NAMEmkdir - create a directory
int mkdir(const char * pathname , mode_t mode );
DESCRIPTIONmkdir() attempts to create a directory named pathname.
RETURN VALUEmkdir() returns zero on success, or -1 if an error occurred (in which case, errno is set appropriately).
- 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).)
- The user's quota of disk blocks or inodes on the file system has been exhausted.
- pathname already exists (not necessarily as a directory). This includes the case where pathname is a symbolic link, dangling or not.
- pathname points outside your accessible address space.
- Too many symbolic links were encountered in resolving pathname.
- The number of links to the parent directory would exceed LINK_MAX.
- pathname was too long.
- A directory component in pathname does not exist or is a dangling symbolic link.
- Insufficient kernel memory was available.
- The device containing pathname has no room for the new directory.
- The new directory cannot be created because the user's disk quota is exhausted.
- A component used as a directory in pathname is not, in fact, a directory.
- The file system containing pathname does not support the creation of directories.
- pathname refers to a file on a read-only file system.
CONFORMING TOSVr4, BSD, POSIX.1-2001.
NOTESUnder 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 ALSOmkdir(1), chmod(2), chown(2), mkdirat(2), mknod(2), mount(2), rmdir(2), stat(2), umask(2), unlink(2), path_resolution(7)
COLOPHONThis page is part of release 3.53 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/.