mkdir - Makes a directory
mkdir [-m mode] [-p] directory...
Interfaces documented on this reference page conform to
industry standards as follows:
Refer to the standards(5) reference page for more information
about industry standards and associated tags.
Sets the file permissions to mode, a symbolic mode string
as defined for chmod, after creating the specified directory.
The mode argument can be either an absolute mode
string or a symbolic mode string as defined for chmod.
See the chmod(1) reference page.
In symbolic mode strings, the operation characters
+ and - are interpreted relative to an assumed initial
mode of a=rwx, A + adds permissions to the
default mode, whereas a - deletes permissions from
the default mode. Creates intermediate directories
as necessary; otherwise, the full path name prefix
to directory must already exist. The user must
have mkdir write permission in the parent directory.
Each component of directory that does not name an
existing directory is created with mode 777, modified
by the current file mode creation mask
(umask). The equivalent of chmod u+wx is performed
on each component to ensure that mkdir can create
lower directories regardless of the setting of
umask. Each component of directory that names an
existing directory is ignored without error. If an
intermediate path name component exists, but permissions
are set to prevent writing or searching,
mkdir fails and returns an error message. The mode
argument does not apply to any intermediate directories
created when the -p option is specified.
The path name of the directory to be created.
The mkdir command creates new directories with read,
write, and execute permissions based upon the permissions
established by the umask setting.
[Tru64 UNIX] The mkdir command also creates the standard
entries (dot) for the directory itself and (dot dot) for
Some of the requested directories may be created although
an error occurs subsequent to the directory creation. If
the directory specified by the -p option already exists,
the command does not return an error status, in compliance
with POSIX.2. [Tru64 UNIX] To make a new directory, you
must have write permission in the parent directory.
The following exit values are returned: All requested
directories were created, or the -p option was used and
all of the requested directories now exist. An error
To create a new directory called test, enter: mkdir test
To set file permissions for new directory test in absolute
mode, enter: mkdir -m 444 test To set file permissions for
new directory test in symbolic mode, enter: mkdir -m+rw
ENVIRONMENT VARIABLES [Toc] [Back]
The following environment variables affect the execution
of mkdir: Provides a default value for the internationalization
variables that are unset or null. If LANG is unset
or null, the corresponding value from the default locale
is used. If any of the internationalization variables
contain an invalid setting, the utility behaves as if none
of the variables had been defined. If set to a non-empty
string value, overrides the values of all the other internationalization
variables. Determines the locale for the
interpretation of sequences of bytes of text data as characters
(for example, single-byte as opposed to multibyte
characters in arguments). Determines the locale for the
format and contents of diagnostic messages written to
standard error. Determines the location of message catalogues
for the processing of LC_MESSAGES.
Commands: chmod(1), rm(1), rmdir(1), Bourne shell sh(1b),
POSIX shell sh(1p), umask(1)
[ Back ]