4BSD/usr/man/cat2/unlink.2

Compare this file to the similar file:
Show the results in this format:



UNLINK(2)           UNIX Programmer's Manual            UNLINK(2)



NAME
     unlink - remove directory entry

SYNOPSIS
     unlink(name)
     char *name;

DESCRIPTION
     _N_a_m_e points to a null-terminated string.  _U_n_l_i_n_k removes the
     entry for the file pointed to by _n_a_m_e 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.

SEE ALSO
     rm(1), link(2)

DIAGNOSTICS
     Zero is normally returned; -1 indicates that the file does
     not exist, that its directory cannot be written, or that the
     file contains pure procedure text that is currently in use.
     Write permission is not required on the file itself.  It is
     also illegal to unlink a directory (except for the super-
     user).

ASSEMBLER (PDP-11)
     (unlink = 10.)
     sys unlink; name

























Printed 11/10/80                                                1