MKDIR(2) MKDIR(2)
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.
[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.
Page 1 May 1989
MKDIR(2) MKDIR(2)
[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.
Page 2 May 1989