2.11BSD#431 - /usr/man/cat2/rmdir.0

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


NAME
     rmdir - remove a directory file

SYNOPSIS
     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
     "..".

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.

     [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 11/26/99	 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]	    Path points outside the process's allocated
		    address space.

SEE ALSO
     mkdir(2), unlink(2)


Printed 11/26/99	 August 26, 1985			2