{
    "mode": "man",
    "parameter": "btrfs-map-logical",
    "section": "8",
    "url": "https://www.chedong.com/phpMan.php/man/btrfs-map-logical/8/json",
    "generated": "2026-10-04T13:26:31Z",
    "synopsis": "btrfs-map-logical <options> <device>",
    "sections": {
        "NAME": {
            "content": "btrfs-map-logical - map btrfs logical extent to physical extent\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "btrfs-map-logical <options> <device>\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "btrfs-map-logical  can  be used to find out what the physical offsets are on the mirrors, the\nresult is dumped to stdout by default.\n\nMainly used for debug purpose.\n",
            "subsections": []
        },
        "OPTIONS": {
            "content": "",
            "subsections": [
                {
                    "name": "-l|--logical <logical_num>",
                    "content": "Logical extent to map.\n"
                },
                {
                    "name": "-c|--copy <copy>",
                    "content": "Copy of the extent to read(usually 1 or 2).\n"
                },
                {
                    "name": "-o|--output <filename>",
                    "content": "Output file to hold the extent.\n"
                },
                {
                    "name": "-b|--bytes <bytes>",
                    "content": "Number of bytes to read.\n"
                }
            ]
        },
        "EXIT STATUS": {
            "content": "btrfs-map-logical 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\n6.6.3                                       Mar 31, 2024                        BTRFS-MAP-LOGICAL(8)",
            "subsections": []
        }
    },
    "summary": "btrfs-map-logical - map btrfs logical extent to physical extent",
    "flags": [
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "Logical extent to map."
        },
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "Copy of the extent to read(usually 1 or 2)."
        },
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "Output file to hold the extent."
        },
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "Number of bytes to read."
        }
    ],
    "examples": [],
    "see_also": [
        {
            "name": "mkfs.btrfs",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/mkfs.btrfs/8/json"
        },
        {
            "name": "BTRFS-MAP-LOGICAL",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/BTRFS-MAP-LOGICAL/8/json"
        }
    ]
}