MKDIR(2-SVR3) RISC/os Reference Manual MKDIR(2-SVR3)
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 per-
mission is denied on the parent direc-
tory 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.
Printed 11/19/92 Page 1
MKDIR(2-SVR3) RISC/os Reference Manual MKDIR(2-SVR3)
[EIO] An I/O error has occurred while access-
ing the file system.
DIAGNOSTICS
Upon successful completion, a value of 0 is returned. Oth-
erwise, a value of -1 is returned, and errno is set to indi-
cate the error.
Page 2 Printed 11/19/92