ChorusOS man pages section 2POSIX: POSIX System Calls

rmdir(2POSIX)

NAME

rmdir- remove a directory file

SYNOPSIS

#include <unistd.h>

path

FEATURES

MSDOSFS, NFS_CLIENT, UFS

DESCRIPTION

The rmdir system call removes a directory file whose name is given by path. The directory must not have any entries other than . (dot) and .. (dot, dot)

RETURN VALUES

If successful, rmdir returns a value of 0, otherwie -1 is returned, and errno is set to indicate one of the following error conditions..

ERRORS

[ENOTDIR]: A component of the path is not a directory.
[EINVAL]: The pathname contains a character with the high-order bit set.
[ENAMETOOLONG]: A component of a pathname exceeded 255 characters, or an entire pathname exceeded 1023 characters.
[ENOENT]: The directory named does not exist.
[ELOOP]: Too many symbolic links were encountered in translating the pathname.
[ENOTEMPTY]: The named directory contains files other than . and .. in it.
[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 directory containing the directory to be removed is marked sticky, and neither the containing directory nor the directory to be removed are owned by the effective user ID.
[EBUSY]: The directory to be removed is the mount point for a mounted file system.
[EIO]: An I/O error occurred while deleting the directory entry or deallocating the inode.
[EROFS]: The directory entry to be removed resides on a read-only file system.
[EFAULT]: path points outside the process's allocated address space.

ATTRIBUTES

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving

HISTORY

This function call appeared in 4.2 BSD.

ChorusOS 4.0 Last Revised December 1999