UNLINK(2)               COMMAND REFERENCE               UNLINK(2)



NAME
     unlink - remove directory entry

SYNOPSIS
     unlink(path)
     char *path;

DESCRIPTION
     Unlink removes the entry for the file path from its
     directory.  If this entry was the last link to the file, and
     no process has the file open, then all resources associated
     with the file are reclaimed.  If, however, the file was open
     in any process, the actual resource reclamation is delayed
     until it is closed, even though the directory entry has
     disappeared.

     Only the super-user may unlink a directory.

DIAGNOSTICS
     The unlink succeeds unless:

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

     [ENAMETOOLONG] The pathname is too long.

     [EIO]          An I/O error occurred while reading from or
                    writing to the file system.

     [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
                    containing 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.

     [ETXTBUSY]     Path is a shared text file that is being
                    executed.

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



Printed 5/12/88                                                 1

UNLINK(2)               COMMAND REFERENCE               UNLINK(2)



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

     [ELOOP]        Too many symbolic links were encountered in
                    translating the pathname.

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
     close(2), link(2), open(2), rmdir(2), and creat(3c).










































Printed 5/12/88                                                 2

%%index%%
na:288,83;
sy:371,345;
de:716,698;
di:1414,1304;3078,219;
rv:3297,280;
se:3577,234;
%%index%%000000000117