mkdir(C)                        19 June 1992                        mkdir(C)


 Name

    mkdir - make a directory

 Syntax

    mkdir [ -m mode ]  [ -p ] [ -e ] dirname ...

 Description

    The mkdir command creates the named directories in mode 777 (possibly
    altered by umask(C)).

    Standard entries in a directory (for example, 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
    real user ID and group ID, respectively.

    Three options apply to mkdir:

    -m   This option allows users to specify the mode to be used for new
         directories.  Choices for modes can be found in chmod(C).

    -p   With this option, mkdir creates dirname by creating all the non-
         existing parent directories first.

    -e   For historical compatibility, mkdir changes the ownership of the new
         directory to the real user ID (RUID) and the real group ID (RGID).
         The -e option says to use the effective user ID (EUID) and effective
         group ID (EGID) instead.

 See also

    mkdir(S), rm(C), rmdir(C), sh(C), umask(C)

 Diagnostics

    The mkdir command returns exit code 0 if all directories given in the
    command line were made successfully.  Otherwise, it prints a diagnostic
    and returns non-zero.  An error code is stored in errno.

 Standards conformance

    mkdir is conformant with AT&T SVID Issue 2.