/sys/doc/ Documentation archive



UNLINK(II)                    8/5/73                   UNLINK(II)



NAME
     unlink - remove directory entry

SYNOPSIS
     (unlink = 10.)
     sys  unlink; name

     unlink(name)
     char *name;

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.

SEE ALSO
     rm(I), rmdir(I), link(II)

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.  It is also
     illegal to unlink a directory (except for  the  super-user).
     From C, a -1 return indicates an error.





























                              - 1 -