unlink(2POSIX)

NAME | SYNOPSIS | FEATURES | DESCRIPTION | RETURN VALUES | ATTRIBUTES | SEE ALSO | BUGS

NAME

unlink- remove a directory entry

SYNOPSIS

#include <unistd.h>

int unlink(const char *path);

FEATURES

MSDOSFS, NFS_CLIENT, UFS

DESCRIPTION

The unlink() system call removes the directory entry named referred to by path.

RETURN VALUES

Upon successful completion, unlink() returns 0. Otherwise it returns -1 and sets errno to indicate one of the following error conditions:

[ENOTDIR]

A component of the path prefix is not a directory.

[ENOENT]

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

[EBUSY]

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

[EROFS]

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

[ENAMETOOLONG]

The length of a component of path exceeds NAME_MAX characters, or the length of path exceeds PATH_MAX characters.

[ELOOP]

Too many symbolic links or symbolic ports were encountered during analysis of path.

[EIO]

An I/O error occurred while making the directory entry or allocating the inode.

[EFAULT]

path points outside the allocated address space of the actor.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving

SEE ALSO

close(2POSIX), open(2POSIX)

BUGS

Weaknesses in the protocol underlying NFS may cause files in directories mounted over NFS to disappear while still in use. In order to avoid this problem, always call close() before calling unlink().

ChorusOS 4.0  Last Revised December 1999

NAME | SYNOPSIS | FEATURES | DESCRIPTION | RETURN VALUES | ATTRIBUTES | SEE ALSO | BUGS