← All commands
THE COMMAND REFERENCE

rm

Remove files and directories.

Last updated

Portable / common

Implementation-level reference; examples are not certified for every installed version.

Overview

rm deletes the files you name. It does not move them to a trash, so a deleted file is gone. Directories need -r.

Background

An rm command appeared in Version 1 Unix, according to the FreeBSD and macOS manuals. Today the name covers GNU rm, the rm that macOS ships, and the rm applet in BusyBox. They agree on -r and -f, and differ on interactive -i, verbose -v, and the empty-directory option -d.

Examples

Delete one file and list what is left:

rm app.log && ls

Delete several files:

rm app.log notes.txt && ls

Delete a directory and everything inside it:

rm -r logs && ls

Ignore a file that does not exist, with no error and a zero exit status:

rm -f missing.txt && echo done

Options

-r
Remove directories and their contents recursively. -R is accepted too.

-f
Never prompt, and do not complain about files that do not exist.

Common mistakes

There is no undo. Check a pattern with ls before you pass it to rm, quote or escape names that contain spaces, and be careful with variables that may be empty: rm -rf $DIR/ with an empty DIR aims at /. Use -- before names that start with a dash, as in rm -- -file.

Portability

Only -r and -f are in the Common examples. Interactive -i, verbose -v and the empty-directory option -d behave differently or are missing between implementations. The Common examples were executed on GNU coreutils 9.11, macOS system tools, and BusyBox 1.37.0 (see the development guide for the exact check).

References

Original explanations, with upstream documentation for further reading. FreeBSD references are comparison material, not a claim of Apple version equivalence.