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).)
- EDQUOT
- The user's quota of disk blocks or inodes on the file system has been exhausted.
- 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.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/.2013-01-27 | Linux |