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.

Releases

7 releases since Debian 8 (Jessie); the text changed 6 times.

  1. 8
  2. 9
  3. 10
  4. 11
  5. 12
  6. 13
  7. Arch

-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.