On success, zero is returned. On error, -1 is returned, and
errno is set appropriately.
ERRORS
EPERM
The filesystem containing
pathname does not support the removal of directories.
EFAULT
pathname " points outside your accessible address space."
EACCES
Write access to the directory containing
pathname was not allowed for the process's effective uid, or one of the
directories in
pathname did not allow search (execute) permission.
EPERM
The directory containing
pathname has the sticky-bit
set and the process's effective uid is neither the uid of the file to
be deleted nor that of the directory containing it.
ENAMETOOLONG
pathname " was too long."
ENOENT
A directory component in
pathname does not exist or is a dangling symbolic link.
ENOTDIR
pathname , or a component used as a directory in
pathname , is not, in fact, a directory.
ENOTEMPTY
pathname contains entries other than
. " and " .. " ."
EINVAL
pathname has
. as last component.
EBUSY
pathname is the current working directory or root directory of some process.
ENOMEM
Insufficient kernel memory was available.
EROFS
pathname refers to a file on a read-only filesystem.
ELOOP
Too many symbolic links were encountered in resolving
pathname .
CONFORMING TO
SVr4, SVID, POSIX, BSD 4.3
BUGS
Infelicities in the protocol underlying NFS can cause the unexpected
disappearance of directories which are still being used.