{
    "mode": "man",
    "parameter": "btrfs-find-root",
    "section": "8",
    "url": "https://www.chedong.com/phpMan.php/man/btrfs-find-root/8/json",
    "generated": "2026-07-05T16:05:16Z",
    "synopsis": "btrfs-find-root [options] <device>",
    "sections": {
        "NAME": {
            "content": "btrfs-find-root - filter to find btrfs root\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "btrfs-find-root [options] <device>\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "btrfs-find-root is used to find the satisfied root, you can filter by root tree’s objectid,\ngeneration, level.\n",
            "subsections": []
        },
        "OPTIONS": {
            "content": "",
            "subsections": [
                {
                    "name": "-a",
                    "content": "Search through all metadata extents, even the root has been already found.\n\n-g <generation>\nFilter root tree by it’s original transaction id, tree root’s generation in default.\n\n-o <objectid>\nFilter root tree by it’s objectid,tree root’s objectid in default.\n\n-l <level>\nFilter root tree by B-+ tree’s level, level 0 in default.\n",
                    "flag": "-a"
                }
            ]
        },
        "EXIT STATUS": {
            "content": "btrfs-find-root will return 0 if no error happened. If any problems happened, 1 will be\nreturned.\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "mkfs.btrfs(8)\n\n\n\nBtrfs v5.16.2                                02/16/2022                           BTRFS-FIND-ROOT(8)",
            "subsections": []
        }
    },
    "summary": "btrfs-find-root - filter to find btrfs root",
    "flags": [
        {
            "flag": "-a",
            "long": null,
            "arg": null,
            "description": "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."
        }
    ],
    "examples": [],
    "see_also": [
        {
            "name": "mkfs.btrfs",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/mkfs.btrfs/8/json"
        },
        {
            "name": "BTRFS-FIND-ROOT",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/BTRFS-FIND-ROOT/8/json"
        }
    ]
}