mkpath_np(3) [osx man page]

mkpath_np(3)						   BSD Library Functions Manual 					      mkpath_np(3)

NAME

     mkpath_np -- Auxiliary routine for efficiently creating paths

SYNOPSIS

     #include <unistd.h>

     int
     mkpath_np(const char * path, mode_t omode);

DESCRIPTION

     This routine allows the caller to create a path, including intermediate directories.  It is equivalent to calling mkdir(1) with the -p com-
     mand line argument.

     Intermediate directories are created with permission bits of rwxrwxrwx (0777) as modified by the current umask, plus write and search permis-
     sion for the owner.

     The leaf directory is created with permission bits of omode as modified by the current umask.

RETURN VALUES

     A 0 return value indicates success.  If an error occurs, the return value is a non-zero error code.  Note that EEXIST is returned iff the
     leaf directory already exists and is a directory, so under certain circumstances, this error value may not indicate a failure state.

     This routine does NOT modify errno.

ERRORS

     Any error code that can be returned by mkdir(2) can be returned by mkpath_np(), but mkpath_np() will return the error code rather than set-
     ting errno.

     [ENOTDIR]		A component of the path is not a directory (in contrast to mkdir(2) which returns this based on the path prefix rather
			than the path).

     [EEXIST]		The path already exists and is a directory.

HISTORY

     This function first appeared in iOS 5.0.

SEE ALSO

     mkdir(1), chmod(2), mkdir(2)

Mac OS X							   July 13, 2011							  Mac OS X

MKDIR(1)						    BSD 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 cur-
     rent 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 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'') compatible.

HISTORY

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

BSD
								  March 15, 2013							       BSD