{
    "mode": "info",
    "parameter": "xfs_bmap",
    "section": "",
    "url": "https://www.chedong.com/phpMan.php/info/xfs_bmap/json",
    "generated": "2026-07-05T23:45:39Z",
    "synopsis": "xfsbmap [ -adelpv ] [ -n numextents ] file\nxfsbmap -V",
    "sections": {
        "NAME": {
            "content": "xfsbmap - print block mapping for an XFS file\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "xfsbmap [ -adelpv ] [ -n numextents ] file\nxfsbmap -V\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "xfsbmap prints the map of disk blocks used by files in an XFS filesys-\ntem.  The map lists each extent used by the file, as well as regions in\nthe  file that do not have any corresponding blocks (holes).  Each line\nof the listings takes the following form:\n\nextent: [startoffset..endoffset]: startblock..endblock\n\nHoles are marked by replacing the startblock..endblock with hole.   All\nthe  file  offsets  and disk blocks are in units of 512-byte blocks, no\nmatter what the filesystem's block size is.\n",
            "subsections": []
        },
        "OPTIONS": {
            "content": "-a     If this option is specified, information about the file's attri-\nbute fork is printed instead of the default data fork.\n\n-e     If  this option is used, xfsbmap obtains all delayed allocation\nextents, and does not flush dirty pages to disk before  querying\nextent  data.  With  the  -v  option, the flags column will show\nwhich extents have not yet been allocated.\n\n-l     If this option is used, then\n\n<nblocks>  blocks\n\nwill be appended to each line.  nblocks is the length of the ex-\ntent described on the line in units of 512-byte blocks.\n\nThis flag has no effect if the -v option is used.\n\n-n numextents\nIf  this  option is given, xfsbmap will display at most numex-\ntents extents. In the absence of -n, xfsbmap will  display  all\nextents in the file.\n\n-p     If this option is used, xfsbmap obtains all unwritten (preallo-\ncated) extents that do not contain written data. With the -v op-\ntion,  the  flags  column  will  show which extents are preallo-\ncated/unwritten.\n\n-v     Shows verbose information. When this flag  is  specified,  addi-\ntional  AG  specific information is appended to each line in the\nfollowing form:\n\nagno (startagoffset..endagoffset) nblocks flags\n\nA second -v option will print out the flags legend.\n\n-V     Prints the version number and exits.\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "xfsfsr(8), xfs(5).\n\nxfsbmap(8)",
            "subsections": []
        }
    },
    "summary": "xfsbmap - print block mapping for an XFS file",
    "flags": [],
    "examples": [],
    "see_also": [
        {
            "name": "xfsfsr",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/xfsfsr/8/json"
        },
        {
            "name": "xfs",
            "section": "5",
            "url": "https://www.chedong.com/phpMan.php/man/xfs/5/json"
        },
        {
            "name": "xfsbmap",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/xfsbmap/8/json"
        }
    ]
}