mkdir

Make directories (POSIX)

Syntax:

mkdir [-m mode] [-p] dir...

Options:

-mmode

When creating the directory, set the permission bits of the new
directory to the specified mode value.

The mode argument is a
symbolic_mode string, as defined for the
chmod utility. In the symbolic_mode
strings, the op characters + and
- are interpreted relative to the default file mode for
that file type:

+

Add permissions to the default mode.

-

Delete permissions from the default mode.

=

Assign permissions.

-p

Create any missing intermediate pathname components.

dir

A pathname at which a directory is to be created.

If you specify both the -p and -m options,
any intermediate directories you have created have mode u+wx.

Description:

The mkdir utility creates the directories specified by
the dir operands, in the order the
dir operands are specified.

To create a directory, you must have write permission on the
parent directory, or be root.

Not all filesystems support the creation of directories.
For example, /dev/shmem (which really isn't a filesystem
but looks like one) doesn't.
For more information, see the
Working with Filesystems
chapter of the QNX Neutrino User's Guide.

The default file mode for directories is a=rwx (777),
with selected permissions removed in accordance with the file mode
creation mask .

For intermediate pathname components created by mkdir,
the mode is the default modified by u+wx so that the
subdirectories can always be created regardless of the file-mode creation
mask. If you want to assign different ultimate permissions for the
intermediate directories, you can do so with the
chmod
utility.

When using -p with -m, each intermediate
directory that doesn't exist is created with u+wx modes,
regardless of the file mode creation mask. The specified
mode applies only to the last directory specified.
For example:

mkdir -p -m 777 dir/dir1/dir2

gives dir and dir1 the default
permissions for intermediate directories (i.e. u+wx).
The directory dir2 is given a+rwx
permission.

The default file-creation mask influences the behavior of mkdir.

Examples:

Create a directory named /home/debbie:

mkdir /home/debbie

Exit status:

0

All the specified directories were created successfully,
or the -p option was specified and all the
specified directories now exist.

>0

An error occurred.

Caveats:

If the mkdir utility is terminated by a signal, some
of the specified directories may have already been created.