In this lesson, you will learn how to use advanced mount options to bypass filesystem corruption and extract your data when a Btrfs volume refuses to mount normally.
Sometimes, a Btrfs filesystem may encounter severe metadata corruption that prevents the standard mount process from completing. Because Btrfs is a Copy-on-Write filesystem, it keeps track of the state of your data through trees. If the tree root is damaged, you need a "rescue" strategy to force the kernel to ignore the corruption and let you access the data.
The ro, recovery, and usebackuproot Options
When a filesystem is damaged, the first step is to attempt a mount in read-only mode to prevent further writes from compounding the damage:
mount -o ro,recovery /dev/sdb1 /mnt/recovery
The recovery option tells Btrfs to attempt to find a valid root tree, even if the primary one is inaccessible. If that fails, your next resort is usebackuproot. Btrfs maintains "backup roots" (older, known-good states of the filesystem tree) in the superblock. You can tell the kernel to ignore the current (damaged) tree and attempt to mount using the last known good backup:
mount -o ro,usebackuproot /dev/sdb1 /mnt/recovery
Strategic Data Extraction
Using these options effectively turns your filesystem into a "read-only snapshot" of itself. Once mounted, do not try to fix the filesystem with btrfs check --repair immediately. Instead, your priority should be to copy your critical data off the volume to a different storage device.
Think of this as performing emergency surgery: you aren't trying to make the patient run a marathon; you are simply trying to stabilize them long enough to get the essential organs (your data) out safely. After you have successfully moved your data to a healthy partition, you can then investigate the cause of the corruption or reformat the drive.
Key Takeaway: When a Btrfs filesystem fails to mount, use the ro, recovery, or usebackuproot mount options to stabilize the volume and copy your data to a safe location before attempting any high-risk repair operations.