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 will fail and no directory will be 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. 

­[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. 

­[ENAMETOOLONG] 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. 

­[ENOSPC] The path prefix resides on a file system which is full. 

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

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

­[ELOOP] The path contains too many symbolic links. 

­[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. 

Version 2.5r1  —  October 29, 1986