Section (1) mkdir
mkdir — make directories
Create the DIRECTORY(ies), if they do not already exist.
Mandatory arguments to long options are mandatory for short options too.
set file mode (as in chmod), not a=rwx − umask
no error if existing, make parent directories as needed
print a message for each created directory
set SELinux security context of each created directory to the default type
−Z, or if CTX is specified then set the SELinux or SMACK security context to CTX
display this help and exit
output version information and exit
GNU coreutils online help: <https://www.gnu.org/software/coreutils/>
Report any translation bugs to <https://translationproject.org/team/>
Full documentation <https://www.gnu.org/software/coreutils/mkdir>
or available locally via: info _zsingle_quotesz_(coreutils) mkdir invocation_zsingle_quotesz_
Copyright © 2019 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.
Section (2) mkdir
mkdir, mkdirat — create a directory
#include <sys/stat.h> #include <sys/types.h>
||const char *pathname,|
#include <fcntl.h> /* Definition of AT_* constants */ #include <sys/stat.h>
|const char *pathname,|
mkdir() attempts to create a
specifies the mode for the new directory (see inode(7)). It is modified
by the process_zsingle_quotesz_s
umask in the
usual way: in the absence of a default ACL, the mode of the
created directory is (
mode & ~
umask & 0777). Whether other
mode bits are honored for the
created directory depends on the operating system. For Linux,
see NOTES below.
The newly created directory will be owned by the effective user ID of the process. If the directory containing the file has the set-group-ID bit set, or if the filesystem is mounted with BSD group semantics (mount -o bsdgroups or, synonymously mount -o grpid), the new directory will inherit the group ownership from its parent; otherwise it will be owned by the effective group ID of the process.
If the parent directory has the set-group-ID bit set, then so will the newly created directory.
mkdirat() system call
operates in exactly the same way as
mkdir(), except for the differences
If the pathname given in
pathname is relative, then it
is interpreted relative to the directory referred to by the
dirfd (rather than relative
to the current working directory of the calling process, as
is done by
mkdir() for a
is the special value
pathname is interpreted
relative to the current working directory of the calling
dirfd is ignored.
See openat(2) for an
explanation of the need for
mkdirat() return 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
pathnamedid not allow search permission. (See also path_resolution(7).)
The user_zsingle_quotesz_s quota of disk blocks or inodes on the filesystem has been exhausted.
pathnamealready exists (not necessarily as a directory). This includes the case where
pathnameis a symbolic link, dangling or not.
pathnamepoints outside your accessible address space.
The final component (basename) of the new directory_zsingle_quotesz_s
pathnameis invalid (e.g., it contains characters not permitted by the underlying filesystem).
Too many symbolic links were encountered in resolving
The number of links to the parent directory would exceed
pathnamewas too long.
A directory component in
pathnamedoes not exist or is a dangling symbolic link.
Insufficient kernel memory was available.
The device containing
pathnamehas no room for the new directory.
The new directory cannot be created because the user_zsingle_quotesz_s disk quota is exhausted.
A component used as a directory in
pathnameis not, in fact, a directory.
The filesystem containing
pathnamedoes not support the creation of directories.
pathnamerefers to a file on a read-only filesystem.
The following additional errors can occur for
dirfdis not a valid file descriptor.
pathnameis relative and
dirfdis a file descriptor referring to a file other than a directory.
mkdirat() was added to Linux
in kernel 2.6.16; library support was added to glibc in
Under Linux, apart from the permission bits, the
mode bit is also honored.
There are many infelicities in the protocol underlying
NFS. Some of these affect
This page is part of release 4.16 of the Linux
man-pages project. A
description of the project, information about reporting bugs,
and the latest version of this page, can be found at
This manpage is Copyright (C) 1992 Drew Eckhardt;
and Copyright (C) 1993 Michael Haardt
and Copyright (C) 1993,1994 Ian Jackson
and Copyright (C) 2006, 2014 Michael Kerrisk
You may distribute it under the terms of the GNU General
Public License. It comes with NO WARRANTY.