124 lines
2.5 KiB
HTML
124 lines
2.5 KiB
HTML
<HTML>
|
|
<HEAD>
|
|
<TITLE>unlink(2)</TITLE>
|
|
</HEAD>
|
|
<BODY>
|
|
<H1>unlink(2)</H1>
|
|
<HR>
|
|
<PRE>
|
|
|
|
</PRE>
|
|
<H2>NAME</H2><PRE>
|
|
unlink - remove directory entry
|
|
|
|
|
|
</PRE>
|
|
<H2>SYNOPSIS</H2><PRE>
|
|
<STRONG>#include</STRONG> <STRONG><unistd.h></STRONG>
|
|
|
|
<STRONG>int</STRONG> <STRONG>unlink(const</STRONG> <STRONG>char</STRONG> <STRONG>*path)</STRONG>
|
|
|
|
|
|
</PRE>
|
|
<H2>DESCRIPTION</H2><PRE>
|
|
<STRONG>Unlink</STRONG> removes the entry for the file <EM>path</EM> 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.
|
|
|
|
|
|
</PRE>
|
|
<H2>RETURN VALUE</H2><PRE>
|
|
Upon successful completion, a value of 0 is returned. Otherwise, a value
|
|
of -1 is returned and <STRONG>errno</STRONG> is set to indicate the error.
|
|
|
|
|
|
</PRE>
|
|
<H2>ERRORS</H2><PRE>
|
|
The <EM>unlink</EM> succeeds unless:
|
|
|
|
[ENOTDIR] A component of the path prefix is not a directory.
|
|
|
|
[ENAMETOOLONG] The path name exceeds PATH_MAX characters.
|
|
|
|
[ENOENT] The named file does not exist.
|
|
|
|
[EACCES] Search permission is denied for a component of the path
|
|
prefix.
|
|
|
|
[EACCES] Write permission is denied on the directory containing the
|
|
link to be removed.
|
|
|
|
[ELOOP] Too many symbolic links were encountered in translating
|
|
the pathname. (Minix-vmd)
|
|
|
|
[EPERM] The named file is a directory.
|
|
|
|
[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)
|
|
|
|
[EBUSY] The entry to be unlinked is the mount point for a mounted
|
|
file system.
|
|
|
|
[EIO] An I/O error occurred while deleting the directory entry
|
|
or deallocating the inode.
|
|
|
|
[EROFS] The named file resides on a read-only file system.
|
|
|
|
[EFAULT] <EM>Path</EM> points outside the process's allocated address space.
|
|
|
|
|
|
</PRE>
|
|
<H2>SEE ALSO</H2><PRE>
|
|
<STRONG><A HREF="../man2/close.2.html">close(2)</A></STRONG>, <STRONG><A HREF="../man2/link.2.html">link(2)</A></STRONG>, <STRONG><A HREF="../man2/rmdir.2.html">rmdir(2)</A></STRONG>.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
</BODY>
|
|
</HTML>
|