RMDIR(2) RMDIR(2)
NAME
rmdir - remove a directory
SYNOPSIS
int rmdir (path)
char *path;
DESCRIPTION
rmdir removes the directory named by the path name pointed
to by path. The directory must not have any entries other
than "." and "..".
The named directory is removed unless one or more of the
following are true:
[EINVAL] The current directory may not be removed.
[EINVAL] The "." entry of a directory may not be
removed.
[EEXIST] The directory contains entries other than
those for "." and "..".
[ENOTDIR] A component of the path prefix is not a
directory.
[ENOENT] The named directory 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 directory to be removed.
[EACCES] The parent directory has the sticky bit set
and
the parent directory is not owned by the user
and
the directory is not owned by the user and
the directory is not writable by the user and
Page 1 May 1989
RMDIR(2) RMDIR(2)
the user is not superuser
[EBUSY] The directory to be removed is the mount
point for a mounted file system.
[EROFS] The directory entry to be removed is part of
a read-only file system.
[EFAULT] Path points outside the process's allocated
address space.
[EIO] An I/O error occurred while accessing the
file system.
[ENOLINK] Path points to a remote machine, and the link
to that machine is no longer active.
[EMULTIHOP] Components of path require hopping to
multiple remote machines.
DIAGNOSTICS
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
mkdir(2).
rmdir(1), rm(1), and mkdir(1) in the User's Reference
Manual.
Page 2 May 1989