Minix Man Pages

home | help
RMDIR(2)                      System Calls Manual                     RMDIR(2)

NAME
       rmdir - remove a directory file

SYNOPSIS
       #include <unistd.h>

       int rmdir(const 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 following are true:

       [ENOTDIR]      A component of the path is not a directory.

       [ENAMETOOLONG] The path name exceeds PATH_MAX characters.

       [ENOENT]       The named directory does not exist.

       [ELOOP]        Too  many symbolic links were encountered in translating
                      the pathname.  (Minix-vmd)

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

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

4.2 Berkeley Distribution       August 26, 1985                       RMDIR(2)
NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | SEE ALSO