Return to mkdir.2 CVS log

Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / man / man2

Annotation of cci/usr/src/man/man2/mkdir.2, revision 1.1.1.2

1.1       root        1: .TH MKDIR 2 "27 July 1983"
                      2: .UC 4
                      3: .SH NAME
                      4: mkdir \- make a directory file
                      5: .SH SYNOPSIS
                      6: .nf
                      7: .ft B
                      8: mkdir(path, mode)
                      9: char *path;
                     10: int mode;
                     11: .fi
                     12: .ft R
                     13: .SH DESCRIPTION
                     14: .I Mkdir
                     15: creates a new directory file with name
                     16: .IR path .
                     17: The mode of the new file
                     18: is initialized from
                     19: .IR mode .
                     20: (The protection part of the mode
                     21: is modified by the process's mode mask; see
                     22: .IR umask (2)).
                     23: .PP
                     24: The directory's owner ID is set to the process's effective user ID.
                     25: The directory's group ID is set to that of the parent directory in
                     26: which it is created.
                     27: .PP
                     28: The low-order 9 bits of mode are modified by the process's
                     29: file mode creation mask: all bits set in the process's file mode
                     30: creation mask are cleared.  See
                     31: .IR umask (2).
                     32: .SH "RETURN VALUE
                     33: A 0 return value indicates success.  A \-1 return value
                     34: indicates an error, and an error code is stored in
                     35: .I errno.
                     36: .SH "ERRORS
                     37: .I Mkdir
1.1.1.2 ! root       38: fails and no directory is created if:
1.1       root       39: .TP 15
                     40: [EPERM]
                     41: The process's effective user ID is not super-user.
                     42: .TP 15
                     43: [EPERM]
                     44: The \fIpath\fP argument contains a byte with the high-order bit set.
                     45: .TP 15
                     46: [ENOTDIR]
                     47: A component of the path prefix is not a directory.
                     48: .TP 15
                     49: [ENOENT]
                     50: A component of the path prefix does not exist.
                     51: .TP 15
                     52: [EROFS]
                     53: The named file resides on a read-only file system.
                     54: .TP 15
                     55: [EEXIST]
                     56: The named file exists.
                     57: .TP 15
                     58: [EFAULT]
                     59: .I Path
                     60: points outside the process's allocated address space.
                     61: .TP 15
                     62: [ELOOP]
                     63: Too many symbolic links were encountered in translating the pathname.
                     64: .TP 15
                     65: [EIO]
                     66: An I/O error occured while writing to the file system.
                     67: .SH "SEE ALSO"
                     68: chmod(2), stat(2), umask(2)

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.