carta
btrfs-find-root(8)

btrfs-find-root8

Filter to find btrfs root

Usage

btrfs-find-root [options] <device>

Overview

btrfs-find-root is used to find the satisfied root, you can filter by root tree's objectid, generation, level.

Options

-a

Search through all metadata extents, even the root has been already found.

-g <generation>

Filter root tree by it's original transaction id, tree root's generation in default.

-o <objectid>

Filter root tree by it's objectid,tree root's objectid in default.

-l <level>

Filter root tree by b-tree's level, level 0 in default.

Exit status

btrfs-find-root will return 0 if no error happened. If any problems happened, 1 will be returned.

History

  • Arch Linux 2026-11-01: the text shown here
  • Debian 13 (Trixie)
  • Debian 12 (Bookworm)
  • Debian 11 (Bullseye)
  • Debian 10 (Buster)
  • Debian 9 (Stretch)
  • Debian 8 (Jessie)

-a since Debian 9 (Stretch).

-g until Debian 11 (Bullseye); -l until Debian 11 (Bullseye); -o until Debian 11 (Bullseye).

From btrfs-progs 7.3-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.