MKDIR(2) SysV 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' mode mask (see umask(2)).
The directory's owner ID is set to the process' effective user ID. The
directory's group ID is set to the process' effective group ID. The
newly created directory is empty with the possible exception of entries
for dot (.) and dot-dot (..).
ERRORS
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.
[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.
[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 as indicated under "Errors."
NOTES
Under other implementations, mkdir fails if any of the following are
true:
[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.
[EMLINK] The maximum number of links to the parent directory would
be exceeded.