NAME

     rmdir - remove a directory file


SYNOPSIS

     #include <unistd.h>

     int rmdir(const char *path)


DESCRIPTION

     Rmdir removes a directory file whose name is given by  path.
     The  directory  must not have any entries other than "." and
     "..".


RETURN VALUE

     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 file is removed unless one or more of the  follow-
     ing are true:

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

     [ENAMETOOLONG] The path name exceeds PATH_MAX characters.

     [ENOENT]       The named directory does not exist.

     [ELOOP]        Too many symbolic links were  encountered  in
                    translating the pathname.  (Minix-vmd)

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


SEE ALSO

     mkdir(2), unlink(2).