---
name: rmdir
status: documented
runtime: pp
source: src/runtime/pp/directory.rs
---
```{index} single: rmdir; Perl built-in (pp runtime)
```

# rmdir

## Synopsis

```perl
rmdir("olddir") or die "Cannot rmdir: $!";
rmdir $_;        # uses $_ if no argument
```

## Description

Removes an empty directory.

Deletes the named directory, which must be empty.  If no argument
is given, uses `$_`.  Returns 1 on success, 0 on failure.  On
failure, sets `$!` to the OS error code (e.g. `ENOTEMPTY`,
`ENOENT`, `EACCES`).

Only empty directories can be removed; use `File::Path::rmtree`
for recursive deletion.

## See also

mkdir, unlink, File::Path