rmdir

Name

rmdir - delete a directory

Library

libc.lib

Synopsis

#include <unistd.h>

int rmdir (const char *path);

Return values

The rmdir() function returns the value 0 if successful; otherwise the value -1 is returned and the global variable errno is set to indicate the error.

Detailed description

The rmdir system call removes a directory file whose name is given by path. The directory must not have any entries other than ‘.’ and ‘..’.

Examples

/**
 *  Detailed description: This test code demonstrates usage of rmdir systemcall, it removes directory
 *  Example from the current working directory.
 *
 *  Preconditions: Expects empty directory "Example" in current working directory.
**/
#include  <unistd.h>
int main()
{
  if(rmdir("Example") < 0 )  
  {
     printf("Rmdir failed \n");
     return -1;
  }
  printf("Directory Example removed \n");
  return 0;
}

Output Directory Example removed

Errors

The named file is removed unless:

[`ENOTDIR`]
	A component of the path is not a directory.
[`ENAMETOOLONG`]
	A component or an entire path name exceeded 255 characters.
[`ENOENT`]
	The named directory does not exist.
[`ELOOP`]
	Too many symbolic links were encountered in translating the pathname.(Not supported)
[`ENOTEMPTY`]
	The named directory contains files other than ‘`.`’ and ‘`..`’ in it.
[`EACCES`]
	Search permission is denied for a component of the path prefix.(Not supported).
[`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.(Not supported)
[`EBUSY`]
	The directory to be removed is the mount point for a mounted file system.(Not supported).
[`EIO`]	An I/O error occurred while deleting the directory entry or deallocating the inode.(Not supported).
[`EROFS`]
	The directory entry to be removed resides on a read-only file system.(Not supported)
[`EFAULT`]
	The path argument points outside the process’s allocated address space.(Not supported).

Feedback

For additional information or queries on this page send feedback