BTRFS-FIND-ROOT(8)

📦
version 7.3 · 20 versions
, in arch rolling

💖 BTRFS-FIND-ROOT 💖

okay bestie, so this is btrfs-find-root, and it lives in the BTRFS manual section (section 8, the sysadmin-flavored one ✨). It's a filter whose whole job is to go find you a btrfs root. That's it, that's the vibe. 🎀

✨ NAME ✨

btrfs-find-root — a filter to find btrfs root 🦋

🌸 SYNOPSIS 🌸

btrfs-find-root [options] <device>

💅 DESCRIPTION 💅

so like, btrfs-find-root is the tool you reach for when you need to find the satisfied root 👑. And because one root is not always the answer you want, you can filter the results by the root tree's objectid, generation, and level. iykyk. 🔥

🎀 OPTIONS 🎀

  • -a — search through all the metadata extents, even if the root has already been found. like, don't stop at the first one, keep going, main character energy 💖
  • -g <generation> — filter the root tree by its original transaction id. defaults to the tree root's generation if you don't say anything ✨
  • -o <objectid> — filter the root tree by its objectid. defaults to the tree root's objectid 🦋
  • -l <level> — filter the root tree by the b-tree's level. defaults to level 0 🌸

💀 EXIT STATUS 💀

btrfs-find-root returns 0 when no error happened — slay, we love a clean run 🫶. But if any problems happened, 1 gets returned. rip, but at least you know. 😭

🌈 SEE ALSO 🌈

mkfs.btrfs(8) <>

okay that's the whole page, no cap 💅 this was the BTRFS manual, version 7.3, dated Oct 24, 2026 — go forth and find your roots bestie 💜🧚

📦 where this page comes from