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 2018-10-29.  (At that time, the date of the most recent commit
       that was found in the repository was 2018-08-06.)  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

Btrfs v4.6.1                     01/23/2018               BTRFS-FIND-ROOT(8)