UNLINK(2)                DOMAIN/IX SYS5                 UNLINK(2)



NAME
     unlink - remove directory entry

USAGE
     unlink(path)
     char *path;


DESCRIPTION
     Unlink removes the entry for the file path from its direc-
     tory.  If this entry was the last link to the file and no
     process has the file open, the system reclaims all resources
     associated with the file.  If a process has the file open,
     the system waits until the file is closed before reclaiming
     resources, even though the directory entry has disappeared.

RETURN VALUE
     A successful call returns zero.  A failed call returns -1
     and sets errno.

ERRORS
     The unlink succeeds unless:

     [EPERM]   The path contains a character with the high-order
               bit set.

     [ENOENT]  The pathname is too long.

     [ENOTDIR] A component of the path prefix is not a directory.

     [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 con-
               taining the link to be removed.

     [EPERM]   The named file is a directory and the effective
               user ID of the process is not the super-user.

     [EBUSY]   The entry to be unlinked is the mount point for a
               mounted file system.

     [EROFS]   The named file resides on a read-only file system.

     [EFAULT]  Path points outside the process's allocated
               address space.

     [ELOOP]   The call encountered too many symbolic links in



Printed 12/4/86                                          UNLINK-1

UNLINK(2)                DOMAIN/IX SYS5                 UNLINK(2)



               translating the pathname.

RELATED INFORMATION
     close(2), link(2), rmdir(2)

















































UNLINK-2                                          Printed 12/4/86