NAME

mkdir − make a directory file

SYNOPSIS

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

DESCRIPTION

Mkdir creates a new directory file with name path.  The mode of the new file is initialized from mode. (The protection part of the mode 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 groups ID. 

The low-order 9 bits of mode are modified by the process’s file mode creation mask: all bits set in the process’s file mode creation mask are cleared.  See umask(2).

RETURN VALUE

A 0 return value indicates success.  A −1 return value indicates an error, and an error code is stored in errno. 

ERRORS

Mkdir will fail and no directory will be created if:

[EPERM] The process’s effective user ID is not super-user. 

[EPERM] The path argument contains a byte with the high-order bit set. 

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

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

[EROFS] The named file resides on a read-only file system. 

[EEXIST] The named file exists. 

[EFAULT] Path points outside the process’s allocated address space. 

[ELOOP] Too many symbolic links were encountered in translating the pathname. 

[EIO] An I/O error occured while writing to the file system. 

SEE ALSO

chmod(2), stat(2), umask(2)

Sun System Release 0.3  —  1 April 1983