.th unlink IV 4/21/86
.sh NAME
unlink - remove directory entry
.sh SYNOPSIS
unlink(name)
.br
char *name;
.ft R
.sh DESCRIPTION
Name points to a null-terminated string.  Unlink removes the entry for
the file pointed to by name from its directory.  If this entry was the
last link to the file, the contents of the file are freed and the file
is destroyed.  If, however, the file was open in any process, the
actual destruction is delayed until it is closed, even though the
directory entry has disappeared.
.sh "SEE ALSO"
link (IV)
.sh DIAGNOSTICS
The error bit (c-bit) is set to indicate that the file does not exist
or that its directory cannot be written.  Write permission is not
required on the file itself.  From C, a -1 return indicates an error.

