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 command line argument.

Intermediate directories are created with permission bits of rwxrwxrwx (0777) as modified by the current umask, plus write and search permission 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 setting 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