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 esta-
	  blished by the umask setting.

     FLAGS
	  -m mode
	      Sets the file permissions	to mode, a symbolic mode
	      string as	defined	for chmod, after creating the speci-
	      fied directory.

	  -p  Creates intermediate directories as necessary; other-
	      wise, 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	exist-
	      ing 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 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 flag is specified.


     DESCRIPTION
	  The mkdir command also creates the standard entries .	(dot),
	  for the directory 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 abso-
	       lute mode, enter:

	       mkdir -m	444 test



	   3.  To set file permissions for new directory test in sym-
	       bolic 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).