rmdir(2)                                                       rmdir(2)

  rmdir()

  NAME

    rmdir(), wcs_rmdir() - remove a directory

  SYNOPSIS

    #include 

    int rmdir (const char *path)
    int wcs_rmdir (const wchar_t *path)

  DESCRIPTION

    The rmdir(2) and wcs_rmdir(2) functions are identical, except that
    wcs_rmdir(2) accepts wide characters in the path argument.

    The rmdir(2) or wcs_rmdir(2) function removes a directory whose name is
    given by path. The directory must not have any entries other than dot (.)
    and dot-dot (..).

    The rmdir(2) or wcs_rmdir(2) function will fail if path specifies the root
    directory.

  RETURN VALUES

    A 0 is returned if the remove succeeds; otherwise a -1 is returned and an
    error code is stored in the global location errno.

  ERRORS

    The named directory is removed unless:

    [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 directory named by path was either the root directory or it was
        the working directory of a process.

    [EBUSY]
        The directory to be removed is the mount point for a mounted file
        system.

    [EINVAL]
        The pathname contains a character with the high-order bit set.

    [EIO]
        An I/O error occurred while deleting the directory entry or
        deallocating the file serial number.

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

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

    [ENAMETOOLONG]
        A component of a pathname exceeded {NAME_MAX} characters, or an entire
        pathname exceeded {PATH_MAX} characters.

    [ENOENT]
        The named directory does not exist.

    [ENOTDIR]
        A component of the path is not a directory.

    [ENOTEMPTY]
        The named directory contains files other than . and .. in it.

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

    [EROFS]
        The directory entry to be removed resides on a read-only file system.

  SEE ALSO

    mkdir(2)

    unlink(2)

  USAGE NOTES

    All of these functions are thread safe.

    All of these functions are async-signal safe.