RMDIR(2-SVR3)       RISC/os Reference Manual        RMDIR(2-SVR3)



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 com-
                         ponent of the path prefix.

     [EACCES]            Write permission is denied on the direc-
                         tory 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 allo-
                         cated 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.




                        Printed 11/19/92                   Page 1

RMDIR(2-SVR3)       RISC/os Reference Manual        RMDIR(2-SVR3)



     [EMULTIHOP]         Components of path require hopping to
                         multiple remote machines.

DIAGNOSTICS
     Upon successful completion, a value of 0 is returned.  Oth-
     erwise, a value of -1 is returned and errno is set to indi-
     cate the error.

SEE ALSO
     mkdir(2).
     rmdir(1), rm(1), and mkdir(1) in the User's Reference
     Manual.











































 Page 2                 Printed 11/19/92