4.3BSD-UWisc/man/cat2/rmdir.2

RMDIR(2)            UNIX Programmer's Manual             RMDIR(2)



NAME
     rmdir - remove a directory file

SYNOPSIS
     rmdir(path)
     char *path;

DESCRIPTION
     _R_m_d_i_r removes a directory file whose name is given by _p_a_t_h.
     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
     _e_r_r_n_o.

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.

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

     [ENAMETOOLONG] A component of a pathname exceeded 255 char-
                    acters, or an entire path name exceeded 1023
                    characters.

     [ENOENT]       The named directory does not exist.

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

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




Printed 12/27/86         August 26, 1985                        1






RMDIR(2)            UNIX Programmer's Manual             RMDIR(2)



     [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]       _P_a_t_h points outside the process's allocated
                    address space.

SEE ALSO
     mkdir(2), unlink(2)












































Printed 12/27/86         August 26, 1985                        2