rmdir() -- System Call (libc)

Remove a directory
#include <unistd.h>
int rmdir(path)
char *path;

The  COHERENT  system  call  rmdir()  removes  the directory  specified  by
argument  path. To  remove  the directory,  the  following conditions  must
apply:

-> path must exist and be accessible,  it must be empty (i.e., contain only
   entries for `.' and `..').

-> You must have permission to remove the directory.

-> The file system that contains path must not be mounted ``read only''.

-> The directory must not be the current directory for any process.

-> The directory must not be a mount point for another file system.

If  the directory  is successfully  removed, rmdir()  returns zero.   If an
error occurs, it returns -1 and sets errno to an appropriate value.

See Also

libc,
mkdir,
mkdir(),
rmdir,
unistd.h,
unlink()
POSIX Standard, §5.5.2

© 2012 by Stephen A. Ness