btrfs-find-root(8) — Linux manual page


BTRFS-FIND-ROOT(8)            Btrfs Manual            BTRFS-FIND-ROOT(8)

NAME         top

       btrfs-find-root - filter to find btrfs root

SYNOPSIS         top

       btrfs-find-root [options] <device>

DESCRIPTION         top

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

OPTIONS         top

           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

       -l <level>
           Filter root tree by B-+ tree’s level, level 0 in default.

EXIT STATUS         top

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

SEE ALSO         top


COLOPHON         top

       This page is part of the btrfs-progs (btrfs filesystem tools)
       project.  Information about the project can be found at 
       If you have a bug report for this manual page, see
       This page was obtained from the project's upstream Git repository
       on 2024-06-14.  (At that time, the date of the most recent commit
       that was found in the repository was 2024-05-02.)  If you
       discover any rendering problems in this HTML version of the page,
       or you believe there is a better or more up-to-date source for
       the page, or you have corrections or improvements to the
       information in this COLOPHON (which is not part of the original
       manual page), send a mail to

Btrfs v5.16.1                  02/06/2022             BTRFS-FIND-ROOT(8)