btrfs-scrub

Start scrub

$ sudo btrfs scrub start path/to/mount

$ sudo btrfs scrub status path/to/mount

$ sudo btrfs scrub cancel path/to/mount

$ sudo btrfs scrub resume path/to/mount

$ sudo btrfs scrub start -B path/to/mount

$ sudo btrfs scrub start -q path/to/mount

btrfs scrub command [OPTIONS] path

btrfs scrub verifies data integrity on btrfs filesystems by reading all data and metadata blocks and checking their checksums. It is recommended to run a scrub monthly to detect and potentially repair corrupted data.

start

Start a scrub operation

Show status of running or last completed scrub

Cancel a running scrub

Resume a cancelled scrub

Do not run in background (foreground mode)

Suppress errors and statistics output

Read-only mode - do not attempt repairs

Scrub can be I/O intensive and may impact system performance. On RAID configurations, scrub can repair errors from redundant copies. Single-disk setups can detect but not repair errors.

btrfs scrub is part of the btrfs-progs package, providing data integrity verification for btrfs filesystems.

btrfs(8), btrfs-balance(8)