btrfs-rescue

Rebuild the filesystem metadata tree (very slow)

$ sudo btrfs rescue chunk-recover [path/to/partition]

$ sudo btrfs rescue fix-device-size [path/to/partition]

$ sudo btrfs rescue super-recover [path/to/partition]

$ sudo btrfs rescue zero-log [path/to/partition]

$ sudo btrfs rescue create-control-device

btrfs rescue subcommand [options] device

btrfs rescue provides recovery tools for damaged btrfs filesystems. These are last-resort commands when normal mounting or btrfs check fails.
Each subcommand addresses specific failure modes like corrupted metadata, superblock damage, or interrupted transactions. The filesystem must be unmounted for all operations.

chunk-recover

Scan and rebuild chunk tree (very slow, hours to days)

Fix device size mismatches preventing mount

Restore superblock from backup copies

Clear the transaction log to fix log replay failures

Create /dev/btrfs-control when mknod unavailable

These are emergency recovery tools. Always backup any recoverable data first. chunk-recover can take extremely long on large filesystems. Some operations may cause data loss. The filesystem must be unmounted.

btrfs(8), btrfs-check(8), btrfs-restore(8)