


      UNLINK(2)                   (UNIX 5.0)                  UNLINK(2)



      NAME
           unlink - remove directory entry

      SYNTAX
           int unlink (path)
           char *path;

      DESCRIPTION
           Unlink removes the directory entry named by the path name
           pointed to by path.  An error can prevent removal:

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

                The named file does not exist.  [ENOENT]

                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.  [EACCES]

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

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

                The entry to be unlinked is the last link to a pure
                procedure (shared text) file that is being executed.
                [ETXTBSY]

                The directory entry to be unlinked is part of a read-
                only file system.  [EROFS]

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

           When all links to a file have been removed and no process
           has the file open, the space occupied by the file is freed
           and the file ceases to exist.  If one or more processes have
           the file open when the last link is removed, the removal is
           postponed until all references to the file have been closed.

      RETURN VALUE
           Upon successful completion, a value of 0 is returned.
           Otherwise, a value of -1 is returned and errno is set to
           indicate the error.

      SEE ALSO
           rm(1), close(2), link(2), open(2).




      Page 1                                         (73 A2 02MTA REV1)






      UNLINK(2)                   (UNIX 5.0)                  UNLINK(2)























































      Page 2                                         (73 A2 02MTA REV1)






