Skip site navigation (1)Skip section navigation (2)

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
MKDIR(1)		FreeBSD	General	Commands Manual		      MKDIR(1)

NAME
     mkdir -- make directories

SYNOPSIS
     mkdir [-pv] [-m mode] directory_name ...

DESCRIPTION
     The mkdir utility creates the directories named as	operands, in the order
     specified,	using mode ``rwxrwxrwx'' (0777)	as modified by the current
     umask(2).

     The options are as	follows:

     -m	mode  Set the file permission bits of the final	created	directory to
	      the specified mode.  The mode argument can be in any of the for-
	      mats specified to	the chmod(1) command.  If a symbolic mode is
	      specified, the operation characters `+' and `-' are interpreted
	      relative to an initial mode of ``a=rwx''.

     -p	      Create intermediate directories as required.  If this option is
	      not specified, the full path prefix of each operand must already
	      exist.  On the other hand, with this option specified, no	error
	      will be reported if a directory given as an operand already
	      exists.  Intermediate directories	are created with permission
	      bits of ``rwxrwxrwx'' (0777) as modified by the current umask,
	      plus write and search permission for the owner.

     -v	      Be verbose when creating directories, listing them as they are
	      created.

     The user must have	write permission in the	parent directory.

EXIT STATUS
     The mkdir utility exits 0 on success, and >0 if an	error occurs.

EXAMPLES
     Create a directory	named foobar:

	   $ mkdir foobar

     Create a directory	named foobar and set its file mode to 700:

	   $ mkdir -m 700 foobar

     Create a directory	named cow/horse/monkey,	creating any non-existent
     intermediate directories as necessary:

	   $ mkdir -p cow/horse/monkey

COMPATIBILITY
     The -v option is non-standard and its use in scripts is not recommended.

SEE ALSO
     rmdir(1)

STANDARDS
     The mkdir utility is expected to be IEEE Std 1003.2 (``POSIX.2'') compat-
     ible.

HISTORY
     A mkdir command appeared in Version 1 AT&T	UNIX.

FreeBSD	9.2			March 15, 2013			   FreeBSD 9.2

NAME | SYNOPSIS | DESCRIPTION | EXIT STATUS | EXAMPLES | COMPATIBILITY | SEE ALSO | STANDARDS | HISTORY

Want to link to this manual page? Use this URL:
<http://www.freebsd.org/cgi/man.cgi?query=mkdir&sektion=1&manpath=FreeBSD+10.0-RELEASE>

home | help