rmdir(2)                                                 rmdir(2)



NAME
     rmdir - remove a directory file

SYNOPSIS
     int rmdir(path)
     char *path;

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

STATUS MESSAGES AND 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.

     The named file is removed unless one or more of the
     following is true:

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

     EPERM
          A pathname contains a character with the high-order bit
          set.

     ENAMETOOLONG
          A component of a pathname exceeded NAME_MAX characters,
          or an entire pathname exceeded PATH_MAX.

     ELOOP
          Too many symbolic links were encountered in translating
          a pathname.

     ENOTDIR
          A component of the path prefix is not a directory.

     ENOENT
          The named file does not exist.

     EACCES
          A component of the path prefix denies search
          permission.

     EACCES
          Write permission is denied on the directory containing
          the link to be removed.

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



January 1992                                                    1

rmdir(2)                                                 rmdir(2)



     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)

     rmdir(1) in A/UX Command Reference











































2                                                    January 1992