NAME

mkdir − make a directory

SYNOPSIS

int mkdir (path, mode)
char ∗path;
int mode;

DESCRIPTION

The routine mkdir creates a new directory with the name path. The mode of the new directory is initialized from the mode. The protection part of the mode argument is modified by the process’s mode mask [see umask(2)].

The directory’s owner ID is set to the process’s effective user ID.  The directory’s group ID is set to the process’s effective group ID.  The newly created directory is empty with the possible exception of entries for “.” and “..”. 

mkdir fails and no directory is created if one or more of the following are true:

­[ENOTDIR] A component of the path prefix is not a directory. 

­[ENOENT] A component of the path prefix does not exist. 

­[ENOLINK] path points to a remote machine and the link to that machine is no longer active. 

­[EMULTIHOP] Components of path require hopping to multiple remote machines. 

­[EACCES] Either a component of the path prefix denies search permission or write permission is denied on the parent directory of the directory to be created. 

­[ENOENT] The path is longer than the maximum allowed. 

­[EEXIST] The named file already exists. 

­[EROFS] The path prefix resides on a read-only file system. 

­[EFAULT] path points outside the allocated address space of the process. 

­[EMLINK] The maximum number of links to the parent directory would be exceeded. 

­[EIO] An I/O error has occurred while accessing the file system. 

DIAGNOSTICS

Upon successful completion, a value of 0 is returned.  Otherwise, a value of −1 is returned, and errno is set to indicate the error. 

September 02, 1992