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

FreeBSD Manual Pages


home | help
mkdir(1)		    General Commands Manual		      mkdir(1)

       mkdir - make a directory

       mode] dirname ...

       creates	specified directories in mode 0777 (possibly altered by	unless
       specified otherwise by a	option (see umask(1)).	Standard entries, (for
       the  directory  itself) and (for	its parent) are	created	automatically.
       If dirname already exists, exits	with a diagnostic message, and the di-
       rectory is not changed.

       recognizes the following	command-line options:

	      After creating the directory as specified,
			  the  file  permissions  are  set to mode, which is a
			  symbolic mode	string as defined for (see  chmod(1)).
			  The has precedence over

	      Intermediate directories are created as necessary.
			  Otherwise,  the full path prefix of dirname must al-
			  ready	exist.	requires write permission in the  par-
			  ent directory.

			  For  each  directory	name in	the pathname prefix of
			  the dirname argument that is not the name of an  ex-
			  isting directory, the	specified directory is created
			  using	the current setting, except that  the  equiva-
			  lent of is done on each component to ensure that can
			  create lower directories regardless of  the  setting
			  of Each directory name in the	pathname prefix	of the
			  dirname argument that	matches	an existing  directory
			  is  ignored  without error.  If an intermediate path
			  component exists, but	has permissions	set to prevent
			  writing or searching,	fails with an error message.

			  If  the  option  is used, the	directory specified by
			  dirname (excluding directories in the	pathname  pre-
			  fix)	is  created  with the permissions specified by

       Only subdirectories can be created (see limits(5)).

   Access Control Lists	- JFS File Systems Only
       If the parent directory has an access control list (ACL,	see  aclv(5)),
       and  that  ACL  contains	default	entries, an ACL	is created for the new
       directory, and the parent directory's default entries  are  applied  to
       the  new	 directory's  ACL,  both as regular entries and	as default en-

   Environment Variables
       provides	a default value	for the	 internationalization  variables  that
       are  unset  or null. If is unset	or null, the default value of "C" (see
       lang(5))	is used. If any	of the internationalization variables contains
       an  invalid  setting,  will behave as if	all internationalization vari-
       ables are set to	"C".  See environ(5).

       If set to a non-empty string value, overrides the  values  of  all  the
       other internationalization variables.

       determines the interpretation of	text as	single and/or multi-byte char-
       acters, the classification of characters	as printable, and the  charac-
       ters matched by character class expressions in regular expressions.

       determines the locale that should be used to affect the format and con-
       tents of	diagnostic messages written to standard	error and  informative
       messages	written	to standard output.

       determines the location of message catalogues for the processing	of

   International Code Set Support
       Single- and multi-byte character	code sets are supported.

       returns exit code 0 if all directories were created successfully.  Oth-
       erwise, it prints a diagnostic and returns non-zero.

       returns exit code 0 if the option was specified,	and all	the  specified
       directories  now	 exist.	 If any	of the intermediate directories	do not
       have search or write permission (with the option), prints a  diagnostic
       and returns non-zero.

       Create directory	beneath	existing directory in the current directory:

       Create  directory path underneath the current directory and set permis-
       sions on	directory to read-only for all users

       which is	equivalent to (see chmod(1)):

       If directories or and already exist, only the  missing  directories  in
       the specified path are created.

       rm(1), setacl(1), sh(1),	umask(1), aclv(5).



Want to link to this manual page? Use this URL:

home | help