mkdir - make directories
mkdir [-m mode] [-p] dir...
The mkdir command creates the named directories in mode 777
(possibly altered by the file mode creation mask umask(1)).
Standard entries in a directory (for instance, the files
".", for the directory itself, and "..", for its parent) are
made automatically. mkdir cannot create these entries by
name. Creation of a directory requires write permission in
the parent directory.
The owner-ID and group-ID of the new directories are set to
the process's effective user-ID and group-ID, respectively.
mkdir calls the mkdir(2) system call.
setgid and mkdir
To change the setgid bit on a newly created directory, you
must use chmod g+s or chmod g-s after executing mkdir.
The setgid bit setting is inherited from the parent direc-
The following options are supported:
This option allows users to specify the mode to
be used for new directories. Choices for modes
can be found in chmod(1).
-p With this option, mkdir creates dir by creating
all the non-existing parent directories first.
The mode given to intermediate directories will
be the difference between 777 and the bits set in
the file mode creation mask. The difference, how-
ever, must be at least 300 (write and execute
permission for the user).
The following operand is supported:
dir A path name of a directory to be created.
See largefile(5) for the description of the behavior of
mkdir when encountering files greater than or equal to 2
Gbyte ( 2**31 bytes).
Example 1: Using mkdir
The following example:
example% mkdir -p ltr/jd/jan
creates the subdirectory structure ltr/jd/jan.
See environ(5) for descriptions of the following environment
variables that affect the execution of mkdir: LANG, LC_ALL,
LC_CTYPE, LC_MESSAGES, and NLSPATH.
The following exit values are returned:
0 All the specified directories were created success-
fully or the -p option was specified and all the
specified directories now exist.
>0 An error occurred.
See attributes(5) for descriptions of the following attri-
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
| Availability | SUNWcsu |
| CSI | enabled |
| Interface Stability | Standard |
rm(1), sh(1), umask(1), intro(2), mkdir(2), attributes(5),
environ(5), largefile(5), standards(5)
Man(1) output converted with