1 2 3 4 5 6 7 8 9 10 11 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 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170
|
<TITLE>remove</TITLE>
<body bgcolor="#ffffcc">
<hr>
<pre>
<h3>REMOVE(3) GNU REMOVE(3)
</h3>
<h3>NAME
</h3> remove - delete a name and possibly the file it refers to
<h3>SYNOPSIS
</h3> #include <stdio.h>
int remove(const char *pathname);
<h3>DESCRIPTION
</h3> remove deletes a name from the filesystem. If that name
was the last link to a file and no processes have the file
open the file is deleted and the space it was using is
made available for reuse.
If the name was the last link to a file but any processes
still have the file open the file will remain in existence
until the last file descriptor referring to it is closed.
If the name referred to a symbolic link the link is
removed.
If the name referred to a socket, fifo or device the name
for it is removed but processes which have the object open
may continue to use it.
<h3>RETURN VALUE
</h3> On success, zero is returned. On error, -1 is returned,
and errno is set appropriately.
<h3>ERRORS
</h3> EFAULT pathname points outside your accessible address
space.
EACCES Write access to the directory containing pathname
is not allowed for the process's effective uid, or
one of the directories in pathname did not allow
search (execute) permission.
EPERM The directory containing pathname has the sticky-
bit (S_ISVTX) set and the process's effective uid
is neither the uid of the file to be deleted nor
that of the directory containing it.
ENAMETOOLONG
pathname was too long.
ENOENT A directory component in pathname does not exist
or is a dangling symbolic link.
ENOTDIR A component used as a directory in pathname is
not, in fact, a directory.
EISDIR pathname refers to a directory.
<h3>Linux 13 July 1994 1
</h3>
<h3>REMOVE(3) GNU REMOVE(3)
</h3>
ENOMEM Insufficient kernel memory was available.
EROFS pathname refers to a file on a read-only filesys-
tem.
<h3>CONFORMING TO
</h3> SVID, AT&T, POSIX, X/OPEN, BSD 4.3
<h3>BUGS
</h3> In-felicities in the protocol underlying NFS can cause the
unexpected disappearance of files which are still being
used.
</pre>
<hr>
<h3>SEE ALSO
</h3><p>
<a href=unlink.htm>unlink</a>,
<a href=rename.htm>rename</a>,
<a href=open.htm>open</a>,
<a href=rmdir.htm>rmdir</a>,
<a href=mknod.htm>mknod</a>,
<a href=mkfifo.htm>mkfifo</a>,
<a href=link.htm>link</a>,
<a href=rm.htm>rm</a>,
<pre>
<h3>Linux 13 July 1994 2
</h3>
</pre>
<P>
<hr>
<p>
<center>
<table border=2 width=80%>
<tr align=center>
<td width=25%>
<a href=../cref.html>Top</a>
</td><td width=25%>
<a href=../master_index.html>Master Index</a>
</td><td width=25%>
<a href=../SYNTAX/keywords.html>Keywords</a>
</td><td width=25%>
<a href=../FUNCTIONS/funcref.htm>Functions</a>
</td>
</tr>
</table>
</center>
<p>
<hr>
This manual page was brought to you by <i>mjl_man V-2.0</i>
|