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

FreeBSD Manual Pages

  
 
  

home | help
MKDIR(1)		     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 formats
	      specified to the chmod(1) command.  If a symbolic mode  is  speci-
	      fied,  the  operation characters `+' and `-' are interpreted rela-
	      tive 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 ex-
	      ists.  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 inter-
     mediate 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") compatible.

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

FreeBSD ports 15.quarterly	 March 15, 2013 			MKDIR(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=mkdir&sektion=1&manpath=FreeBSD+15.1-RELEASE+and+Ports.quarterly>

home | help