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.

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




     Page 1                                        (last mod. 8/20/87)

     RMDIR(2)                                                 RMDIR(2)



     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.

     ORIGIN
          AT&T V.3











































     Page 2                                        (last mod. 8/20/87)