BTRFS-SELECT-SUPER(8)

πŸ’… NAME πŸ’…

btrfs-select-super β€” overwrite primary superblock with a backup copy


✨ SYNOPSIS ✨

btrfs-select-super -s number <device>

🫢 DESCRIPTION 🫢

Okay bestie, listen. This one is destructive β€” it overwrites all copies of the superblock with a copy you specify. Not one. All of them. It's giving "no undo button, we're doing this live" energy. πŸ’€

But it's also a genuine lifesaver in certain cases, for real:

  • when write barriers were disabled during a power failure and not all superblocks got written πŸ₯΄
  • or if the primary superblock is damaged, like accidentally overwritten πŸ™ˆ

The filesystem specified by device must not be mounted. Not "probably shouldn't be". It must not. Mounted = no. 🚫

Note: Prior to overwriting the primary superblock, please make sure that the backup copies are valid! Like, actually check. Bestie. Please. πŸ™

To dump a superblock, use the btrfs inspect-internal dump-super command. That's the vibe check for your superblocks. πŸ‘‘

Then run the check (in the non-repair mode) using the command btrfs check -s, where -s specifies the superblock copy to use.

Superblock copies exist in the following offsets on the device:

  • primary: 64KiB (65536)
  • 1st copy: 64MiB (67108864)
  • 2nd copy: 256GiB (274877906944)

A superblock size is 4KiB (4096). Tiny icon for such a big job, honestly. πŸŽ€


🌸 OPTIONS 🌸

  • -s, --super <N> β€” use the *N*th superblock copy. Valid values are 0, 1, or 2 β€” but only if the respective superblock offset is actually within the device size. No cheating physics, bestie. πŸ¦‹

πŸŽ€ SEE ALSO πŸŽ€


That's the whole page, babes. Lowestkey one of the scariest tools in the box, so treat it with main character responsibility. πŸ’œ

mwah πŸ’‹ β€” this was btrfs-select-super from btrfs 7.3, dated Oct 24, 2026. Slay, go fix that superblock. 🌈✨

πŸ“¦ where this page comes from