mkdir(1)mkdir(1)NAMEmkdir - 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 cre‐
ated 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 pre‐
fix of the dirname argument that matches an existing
directory is ignored without error. If an interme‐
diate 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 pre‐
fix) 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 con‐
tains 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 char‐
acters, the classification of characters as printable, and the charac‐
ters matched by character class expressions in regular expressions.
determines the locale that should be used to affect the format and con‐
tents of diagnostic messages written to standard error and informative
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. Oth‐
erwise, 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 permis‐
sions 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 ALSOrm(1), setacl(1), sh(1), umask(1), aclv(5), standards(5).
STANDARDS CONFORMANCEmkdir(1)