MKDIR(1) BSD General Commands Manual MKDIR(1)NAME
mkdir -- make directories
SYNOPSIS
mkdir [-pv] [-m mode] directory_name ...
DESCRIPTION
The mkdir utility creates the directories named as operands, in the order specified, using mode ``rwxrwxrwx'' (0777) as modified by the cur-
rent umask(2).
The options are as follows:
-m mode Set the file permission bits of the final created directory to the specified mode. The mode argument can be in any of the formats
specified to the chmod(1) command. If a symbolic mode is specified, the operation characters '+' and '-' are interpreted relative
to an initial mode of ``a=rwx''.
-p Create intermediate directories as required. If this option is not specified, the full path prefix of each operand must already
exist. On the other hand, with this option specified, no error will be reported if a directory given as an operand already exists.
Intermediate directories are created with permission bits of ``rwxrwxrwx'' (0777) as modified by the current umask, plus write and
search permission for the owner.
-v Be verbose when creating directories, listing them as they are created.
The user must have write permission in the parent directory.
EXIT STATUS
The mkdir utility exits 0 on success, and >0 if an error occurs.
EXAMPLES
Create a directory named foobar:
$ mkdir foobar
Create a directory named foobar and set its file mode to 700:
$ mkdir -m 700 foobar
Create a directory named cow/horse/monkey, creating any non-existent intermediate directories as necessary:
$ mkdir -p cow/horse/monkey
COMPATIBILITY
The -v option is non-standard and its use in scripts is not recommended.
SEE ALSO rmdir(1)STANDARDS
The mkdir utility is expected to be IEEE Std 1003.2 (``POSIX.2'') compatible.
HISTORY
A mkdir command appeared in Version 1 AT&T UNIX.
BSD March 15, 2013 BSD
Check Out this Related Man Page
mkdir(1) General Commands Manual mkdir(1)NAME
mkdir - make a directory
SYNOPSIS
mode] dirname ...
DESCRIPTION
creates specified directories in mode 0777 (possibly altered by unless specified otherwise by a option (see umask(1)). Standard entries,
(for the directory itself) and (for its parent) are created automatically. If dirname already exists, exits with a diagnostic message, and
the directory is not changed.
Options
recognizes the following command-line options:
After creating the directory as specified,
the file permissions are set to mode, which is a symbolic mode string as defined for (see chmod(1)). The has precedence
over
Intermediate directories are created as necessary.
Otherwise, the full path prefix of dirname must already exist. requires write permission in the parent directory.
For each directory name in the pathname prefix of the dirname argument that is not the name of an existing directory,
the specified directory is created using the current setting, except that the equivalent of is done on each component to
ensure that can create lower directories regardless of the setting of Each directory name in the pathname prefix of the
dirname argument that matches an existing directory is ignored without error. If an intermediate path component exists,
but has permissions set to prevent writing or searching, fails with an error message.
If the option is used, the directory specified by dirname (excluding directories in the pathname prefix) is created with
the permissions specified by mode.
Only subdirectories can be created (see limits(5)).
Access Control Lists - JFS File Systems Only
If the parent directory has an access control list (ACL, see aclv(5)), and that ACL contains default entries, an ACL is created for the new
directory, and the parent directory's default entries are applied to the new directory's ACL, both as regular entries and as default
entries.
EXTERNAL INFLUENCES
For information about the UNIX standard environment, see standards(5).
Environment Variables
provides a default value for the internationalization variables that are unset or null. If is unset or null, the default value of "C" (see
lang(5)) is used. If any of the internationalization variables contains an invalid setting, will behave as if all internationalization
variables are set to See environ(5).
If set to a non-empty string value, overrides the values of all the other internationalization variables.
determines the interpretation of text as single and/or multi-byte characters, the classification of characters as printable, and the char-
acters matched by character class expressions in regular expressions.
determines the locale that should be used to affect the format and contents of diagnostic messages written to standard error and informa-
tive messages written to standard output.
determines the location of message catalogues for the processing of
International Code Set Support
Single- and multi-byte character code sets are supported.
DIAGNOSTICS
returns exit code 0 if all directories were created successfully. Otherwise, it prints a diagnostic and returns non-zero.
returns exit code 0 if the option was specified, and all the specified directories now exist. If any of the intermediate directories do
not have search or write permission (with the option), prints a diagnostic and returns non-zero.
EXAMPLES
Create directory beneath existing directory in the current directory:
Create directory path underneath the current directory and set permissions on directory to read-only for all users
which is equivalent to (see chmod(1)):
If directories or and already exist, only the missing directories in the specified path are created.
SEE ALSO rm(1), setacl(1), sh(1), umask(1), aclv(5), standards(5).
STANDARDS CONFORMANCE mkdir(1)