--one-file-system
Stay on one file system during recursive removal (--one-file-system).
An option of rmx.
Usage
rmx --one-file-system [FILE]...Description
When removing a hierarchy recursively, --one-file-system skips any subdirectory that lives on a different file system than the argument the removal started from. It guards against accidentally descending into a mounted volume. On Windows, where device identity is unavailable, the flag is a no-op.
Permissions
The flag compares device IDs (via stat) and needs no extra permissions beyond those recursive removal already requires. Skipped mount points are reported on stderr and are not treated as errors.
Use cases
- Clearing a directory that contains mounted volumes without deleting across the mount.
- Safely removing a tree on the root file system while leaving mounted disks intact.
- Cleaning container or chroot scratch trees that have bind mounts inside.
- Adding a guard to scripted recursive deletes whose targets may contain mounts.
Details
| Short | Long | Value | Default | Meaning |
|---|---|---|---|---|
--one-file-system | none | when removing recursively, skip directories on a different file system |
Examples
Remove a tree but skip file systems mounted beneath it
rmx -r --one-file-system /dataReport each removal while staying on one file system
rmx -rv --one-file-system scratch/Unattended cleanup of a chroot that may contain bind mounts
rmx -rf --one-file-system chroot/Check the result in a script
rmx -r --one-file-system build/ && echox "build removed"Help in the terminal
gnux help rmx --one-file-system