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

FreeBSD Manual Pages

  
 
  

home | help
mkdir(1)			 User Commands			      mkdir(1)

NAME
       mkdir - make directories

SYNOPSIS
       mkdir [-m mode] [-p] dir...

DESCRIPTION
       The  mkdir  command creates the named directories in mode 777 (possibly
       altered by the file mode	creation mask umask(1)).

       Standard	entries	in a directory (for instance, 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 effective user-ID and group-ID, respectively. mkdir calls the
       mkdir(2)	system call.

   setgid and mkdir
       To  change  the	setgid	bit on a newly created directory, you must use
       chmod g+s or chmod g-s after executing mkdir.

       The setgid bit setting is inherited from	the parent directory.

OPTIONS
       The following options are supported:

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

       -p	       With this option, mkdir creates dir by creating all the
		       non-existing  parent  directories first.	The mode given
		       to intermediate	directories  will  be  the  difference
		       between	777 and	the bits set in	the file mode creation
		       mask. The difference, however, must  be	at  least  300
		       (write and execute permission for the user).

OPERANDS
       The following operand is	supported:

       dir	A path name of a directory to be created.

USAGE
       See  largefile(5)  for  the  description	 of the	behavior of mkdir when
       encountering files greater than or equal	to 2 Gbyte ( 2**31 bytes).

EXAMPLES
       Example 1: Using	mkdir

       The following example:

       example%	mkdir -p ltr/jd/jan

       creates the subdirectory	structure ltr/jd/jan.

ENVIRONMENT VARIABLES
       See environ(5) for descriptions of the following	environment  variables
       that  affect  the  execution  of	mkdir: LANG, LC_ALL, LC_CTYPE, LC_MES-
       SAGES, and NLSPATH.

EXIT STATUS
       The following exit values are returned:

       0	All the	specified directories were created successfully	or the
		-p  option was specified and all the specified directories now
		exist.

       >0	An error occurred.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE	TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWcsu			   |
       +-----------------------------+-----------------------------+
       |CSI			     |enabled			   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       rm(1), sh(1), umask(1), intro(2), mkdir(2), attributes(5),  environ(5),
       largefile(5), standards(5)

SunOS 5.10			  1 Feb	1995			      mkdir(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | USAGE | EXAMPLES | ENVIRONMENT VARIABLES | EXIT STATUS | ATTRIBUTES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=mkdir&sektion=1&manpath=SunOS+5.10>

home | help