Repository navigation
Expand file tree
/
Copy pathunlink.2
More file actions
84 lines (83 loc) · 1.99 KB
/
Copy pathunlink.2
File metadata and controls
84 lines (83 loc) · 1.99 KB
1
2
3
4
5
6
7
8
9
10
11
9BF2
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
.\" Copyright (c) 1980 Regents of the University of California.
.\" All rights reserved. The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
.\" @(#)unlink.2 6.2 (Berkeley) 5/22/85
.\"
.TH UNLINK 2 "May 22, 1985"
.UC 4
.SH NAME
unlink \- remove directory entry
.SH SYNOPSIS
.nf
.ft B
#include <unistd.h>
int unlink(const char *path)
.fi
.ft R
.SH DESCRIPTION
.B Unlink
removes the entry for the file
.I path
from its directory.
If this entry was the last link to the file,
and no process has the file open, then
all resources associated with the file are reclaimed.
If, however, the file was open in any process, the actual
resource reclamation is delayed until it is closed,
even though the directory entry has disappeared.
.SH "RETURN VALUE
Upon successful completion, a value of 0 is returned.
Otherwise, a value of \-1 is returned and
.B errno
is set to indicate the error.
.SH "ERRORS
The \fIunlink\fP succeeds unless:
.TP 15
[ENOTDIR]
A component of the path prefix is not a directory.
.TP 15
[ENAMETOOLONG]
The path name exceeds PATH_MAX characters.
.TP 15
[ENOENT]
The named file does not exist.
.TP 15
[EACCES]
Search permission is denied for a component of the path prefix.
.TP 15
[EACCES]
Write permission is denied on the directory containing the link
to be removed.
.TP 15
[ELOOP]
Too many symbolic links were encountered in translating the pathname.
(Minix-vmd)
.TP 15
[EPERM]
The named file is a directory.
.TP 15
[EPERM]
The directory containing the file is marked sticky,
and neither the containing directory nor the file to be removed
are owned by the effective user ID.
(Minix-vmd)
.TP 15
[EBUSY]
The entry to be unlinked is the mount point for a
mounted file system.
.TP 15
[EIO]
An I/O error occurred while deleting the directory entry
or deallocating the inode.
.TP 15
[EROFS]
The named file resides on a read-only file system.
.TP 15
[EFAULT]
.I Path
points outside the process's allocated address space.
.SH "SEE ALSO"
.BR close (2),
.BR link (2),
.BR rmdir (2).