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.

     [EACCES]
         If the file is located on a remote host, this error code
         will be returned if the local host name and local user
         name does not appear in /usr/lib/dfs/access on the
         remote machine.  See access(dfs)(5n).




Printed 10/17/86                                                1

UNLINK(2)               COMMAND REFERENCE               UNLINK(2)



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

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

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

     [EDFSNOSUCHHOST]
         The pathname referenced a remote host, but when we
         broadcast a request for its address, no host responded.

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), creat(3c).






















Printed 10/17/86                                                2

%%index%%
na:72,67;
sy:139,225;
de:364,606;
di:970,1034;2148,738;
rv:2886,236;
se:3122,182;
%%index%%000000000115