mkdir(1)							     mkdir(1)



NAME
  mkdir - Makes a directory

SYNOPSIS

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

  The mkdir command creates new directories with read, write, and execute
  permissions based upon the permissions established by the umask setting.

FLAGS

  -m mode
      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.
      In symbolic mode strings, the operation characters + and - are inter-
      preted relative to an assumed initial mode of a=rwx, A + adds permis-
      sions to the default mode, whereas a - deletes permissions from the
      default mode.

  -p  Creates intermediate directories as necessary; otherwise, the full
      pathname prefix to directory must already exist.	Note that mkdir
      requires write permission in the parent directory for users other than
      root.
      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, except for the last component.  If
      an intermediate pathname 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 flag is specified.

      Note that if the directory specified by the -p flag already exists, the
      command fails with a message to the user, but does not return an error
      status, in compliance with POSIX.2.

DESCRIPTION

  The mkdir command also creates the standard entries . (dot) for the direc-
  tory itself and .. (dot dot) for its parent.

EXAMPLES

   1.  To create a new directory called test, enter:
	    mkdir test


   2.  To set file permissions for new directory test in absolute mode,
       enter:
	    mkdir -m 444 test


   3.  To set file permissions for new directory test in symbolic mode,
       enter:
	    mkdir -m+rw test


NOTES

  To make a new directory, you must have write permission in the parent
  directory.

RELATED INFORMATION

  Commands:  chmod(1), rm(1), sh(1).

  Functions:  mkdir(2).