Return to mkdir.2 CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / man / man2

Annotation of 43BSDTahoe/man/man2/mkdir.2, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1983 Regents of the University of California.
                      2: .\" All rights reserved.  The Berkeley software License Agreement
                      3: .\" specifies the terms and conditions for redistribution.
                      4: .\"
                      5: .\"    @(#)mkdir.2     6.4 (Berkeley) 8/26/85
                      6: .\"
                      7: .TH MKDIR 2 "August 26, 1985"
                      8: .UC 5
                      9: .SH NAME
                     10: mkdir \- make a directory file
                     11: .SH SYNOPSIS
                     12: .nf
                     13: .ft B
                     14: mkdir(path, mode)
                     15: char *path;
                     16: int mode;
                     17: .fi
                     18: .ft R
                     19: .SH DESCRIPTION
                     20: .I Mkdir
                     21: creates a new directory file with name
                     22: .IR path .
                     23: The mode of the new file
                     24: is initialized from
                     25: .IR mode .
                     26: (The protection part of the mode
                     27: is modified by the process's mode mask; see
                     28: .IR umask (2)).
                     29: .PP
                     30: The directory's owner ID is set to the process's effective user ID.
                     31: The directory's group ID is set to that of the parent directory in
                     32: which it is created.
                     33: .PP
                     34: The low-order 9 bits of mode are modified by the process's
                     35: file mode creation mask: all bits set in the process's file mode
                     36: creation mask are cleared.  See
                     37: .IR umask (2).
                     38: .SH "RETURN VALUE
                     39: A 0 return value indicates success.  A \-1 return value
                     40: indicates an error, and an error code is stored in
                     41: .I errno.
                     42: .SH "ERRORS
                     43: .I Mkdir
                     44: will fail and no directory will be created if:
                     45: .TP 15
                     46: [ENOTDIR]
                     47: A component of the path prefix is not a directory.
                     48: .TP 15
                     49: [EINVAL]
                     50: The pathname contains a character with the high-order bit set.
                     51: .TP 15
                     52: [ENAMETOOLONG]
                     53: A component of a pathname exceeded 255 characters,
                     54: or an entire path name exceeded 1023 characters.
                     55: .TP 15
                     56: [ENOENT]
                     57: A component of the path prefix does not exist.
                     58: .TP 15
                     59: [EACCES]
                     60: Search permission is denied for a component of the path prefix.
                     61: .TP 15
                     62: [ELOOP]
                     63: Too many symbolic links were encountered in translating the pathname.
                     64: .TP 15
                     65: [EPERM]
                     66: The \fIpath\fP argument contains a byte with the high-order bit set.
                     67: .TP 15
                     68: [EROFS]
                     69: The named file resides on a read-only file system.
                     70: .TP 15
                     71: [EEXIST]
                     72: The named file exists.
                     73: .TP 15
                     74: [ENOSPC]
                     75: The directory in which the entry for the new directory is being placed
                     76: cannot be extended because there is no space left on the file
                     77: system containing the directory.
                     78: .TP 15
                     79: [ENOSPC]
                     80: The new directory cannot be created because there
                     81: there is no space left on the file
                     82: system that will contain the directory.
                     83: .TP 15
                     84: [ENOSPC]
                     85: There are no free inodes on the file system on which the
                     86: directory is being created.
                     87: .TP 15
                     88: [EDQUOT]
                     89: The directory in which the entry for the new directory
                     90: is being placed cannot be extended because the
                     91: user's quota of disk blocks on the file system
                     92: containing the directory has been exhausted.
                     93: .TP 15
                     94: [EDQUOT]
                     95: The new directory cannot be created because the user's
                     96: quota of disk blocks on the file system that will
                     97: contain the directory has been exhausted.
                     98: .TP 15
                     99: [EDQUOT]
                    100: The user's quota of inodes on the file system on
                    101: which the directory is being created has been exhausted.
                    102: .TP 15
                    103: [EIO]
                    104: An I/O error occurred while making the directory entry or allocating the inode.
                    105: .TP 15
                    106: [EIO]
                    107: An I/O error occurred while reading from or writing to the file system.
                    108: .TP 15
                    109: [EFAULT]
                    110: .I Path
                    111: points outside the process's allocated address space.
                    112: .SH "SEE ALSO"
                    113: 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.