|
|
1.1 root 1: .TH RMDIR 2 "2 July 1983"
2: .UC 4
3: .SH NAME
4: rmdir \- remove a directory file
5: .SH SYNOPSIS
6: .nf
7: .ft B
8: rmdir(path)
9: char *path;
10: .fi
11: .ft R
12: .SH DESCRIPTION
13: .I Rmdir
14: removes a directory file
15: whose name is given by
16: .I path.
17: The directory must not have any entries other
18: than \*(lq.\*(rq and \*(lq..\*(rq.
19: .SH "RETURN VALUE
20: A 0 is returned if the remove succeeds; otherwise a \-1 is
21: returned and an error code is stored in the global location \fIerrno\fP\|.
22: .SH ERRORS
23: The named file is removed unless one or more of the
24: following are true:
25: .TP 15
26: [ENOTEMPTY]
27: The named directory contains files other than ``.'' and ``..'' in it.
28: .TP 15
29: [EPERM]
30: The pathname contains a character with the high-order bit set.
31: .TP 15
32: [ENOENT]
33: The pathname was too long.
34: .TP 15
35: [ENOTDIR]
36: A component of the path prefix is not a directory.
37: .TP 15
38: [ENOENT]
39: The named file does not exist.
40: .TP 15
41: [EACCES]
42: A component of the path prefix denies search permission.
43: .TP 15
44: [EACCES]
45: Write permission is denied on the directory containing the link
46: to be removed.
47: .TP 15
48: [EBUSY]
49: The directory to be removed is the mount point
50: for a mounted file system.
51: .TP 15
52: [EROFS]
53: The directory entry to be removed resides on a read-only file system.
54: .TP 15
55: [EFAULT]
56: .I Path
57: points outside the process's allocated address space.
58: .TP 15
59: [ELOOP]
60: Too many symbolic links were encountered in translating the pathname.
61: .SH "SEE ALSO"
62: mkdir(2), unlink(2)
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.