-r, -R, --recursive, --recursive-upper
Remove directories and their contents recursively (-r, -R).
An option of rmx.
Usage
rmx -r [FILE]...
rmx --recursive [FILE]...
rmx -R [FILE]...
rmx --recursive-upper [FILE]...Description
By default rmx refuses to remove directories. -r (or its alias -R) removes each directory and everything beneath it, walking the tree post-order so children are removed before their parents. It composes with the other flags: -ri prompts per entry, -rv reports each removal, -rf deletes without prompting.
Permissions
Recursive removal needs read+execute permission to list and descend into each directory, and write permission on a directory to unlink the entries inside it. A directory you cannot write to fails with 'Permission denied' and its contents are left in place. The --preserve-root failsafe additionally refuses to recurse on '/'.
Use cases
- Deleting a directory and all of its contents in one command.
- Clearing build/output trees (build/, dist/, node_modules/).
- Combining with
-i/-Ifor confirmation or-vto audit a large delete. - Resetting a generated directory before regenerating it.
Details
| Short | Long | Value | Default | Meaning |
|---|---|---|---|---|
-r | --recursive | none | remove directories and their contents recursively | |
-R | --recursive-upper | none | equivalent to -r |
Examples
Remove a directory and everything under it
rmx -r logs/Recursively remove a directory, printing each deletion
rmx -rv cache/Use the -R spelling, as with GNU rm
rmx -R dist/Remove several trees without prompting
rmx -rf node_modules/ coverage/Reset a directory and recreate it empty
rmx -rf out/ && mkdirx outRecursively clean up with the gnux shell
gnux shell -c 'rmx -r tmp-*'Help in the terminal
gnux help rmx --recursive