{ "content": [ { "type": "text", "text": "# filefrag(8) (man)\n\n## TLDR\n\n> Report how badly fragmented a particular file might be.\n\n- Display a report for one or more files:\n `filefrag {{path/to/file1 path/to/file2 ...}}`\n- Display a report using a 1024 byte blocksize:\n `filefrag -k {{path/to/file}}`\n- Display a report using a certain blocksize:\n `filefrag -b{{1024|1K|1M|1G|...}} {{path/to/file}}`\n- Sync the file before requesting the mapping:\n `filefrag -s {{path/to/file1 path/to/file2 ...}}`\n- Display mapping of extended attributes:\n `filefrag -x {{path/to/file1 path/to/file2 ...}}`\n- Display a report with verbose information:\n `filefrag -v {{path/to/file1 path/to/file2 ...}}`\n\n*Source: tldr-pages*\n\n---\n\n**Summary:** filefrag - report on file fragmentation\n\n**Synopsis:** filefrag [ -bblocksize ] [ -BeEkPsvVxX ] [ files... ]\n\n## Flags\n\n| Flag | Long | Arg | Description |\n|------|------|-----|-------------|\n| -B | — | — | poses. |\n| -b | — | — | Use blocksize in bytes, or with [KMG] suffix, up to 1GB for output instead of the file system blocksize. For compatibili |\n| -e | — | — | |\n| -E | — | — | all kernels, and is only supported on ext4 file systems. |\n| -k | — | — | |\n| -P | — | — | nels, and is only supported on ext4 file systems. |\n| -s | — | — | |\n| -v | — | — | |\n| -V | — | — | flags that are understood by the current version. |\n| -x | — | — | |\n| -X | — | — | |\n\n## Section Outline\n\n- **NAME** (2 lines)\n- **SYNOPSIS** (2 lines)\n- **DESCRIPTION** (7 lines)\n- **OPTIONS** (1 lines) — 11 subsections\n - -B (2 lines)\n - -b (5 lines)\n - -e (1 lines)\n - -E (2 lines)\n - -k (1 lines)\n - -P (2 lines)\n - -s (1 lines)\n - -v (1 lines)\n - -V (2 lines)\n - -x (1 lines)\n - -X (1 lines)\n- **AUTHOR** (5 lines)\n\n## Full Content\n\n### NAME\n\nfilefrag - report on file fragmentation\n\n### SYNOPSIS\n\nfilefrag [ -bblocksize ] [ -BeEkPsvVxX ] [ files... ]\n\n### DESCRIPTION\n\nfilefrag reports on how badly fragmented a particular file might be. It makes allowances for\nindirect blocks for ext2 and ext3 file systems, but can be used on files for any file system.\n\nThe filefrag program initially attempts to get the extent information using FIEMAP ioctl\nwhich is more efficient and faster. If FIEMAP is not supported then filefrag will fall back\nto using FIBMAP.\n\n### OPTIONS\n\n#### -B\n\nposes.\n\n#### -b\n\nUse blocksize in bytes, or with [KMG] suffix, up to 1GB for output instead of the file\nsystem blocksize. For compatibility with earlier versions of filefrag, if blocksize\nis unspecified it defaults to 1024 bytes. Since blocksize is an optional argument, it\nmust be added without any space after -b.\n\n#### -e\n\n#### -E\n\nall kernels, and is only supported on ext4 file systems.\n\n#### -k\n\n#### -P\n\nnels, and is only supported on ext4 file systems.\n\n#### -s\n\n#### -v\n\n#### -V\n\nflags that are understood by the current version.\n\n#### -x\n\n#### -X\n\n### AUTHOR\n\nfilefrag was written by Theodore Ts'o .\n\n\n\nE2fsprogs version 1.46.5 December 2021 FILEFRAG(8)\n\n" } ], "structuredContent": { "command": "filefrag", "section": "8", "mode": "man", "summary": "filefrag - report on file fragmentation", "synopsis": "filefrag [ -bblocksize ] [ -BeEkPsvVxX ] [ files... ]", "tldr_summary": "Report how badly fragmented a particular file might be.", "tldr_examples": [ { "description": "Display a report for one or more files", "command": "filefrag {{path/to/file1 path/to/file2 ...}}" }, { "description": "Display a report using a 1024 byte blocksize", "command": "filefrag -k {{path/to/file}}" }, { "description": "Display a report using a certain blocksize", "command": "filefrag -b{{1024|1K|1M|1G|...}} {{path/to/file}}" }, { "description": "Sync the file before requesting the mapping", "command": "filefrag -s {{path/to/file1 path/to/file2 ...}}" }, { "description": "Display mapping of extended attributes", "command": "filefrag -x {{path/to/file1 path/to/file2 ...}}" }, { "description": "Display a report with verbose information", "command": "filefrag -v {{path/to/file1 path/to/file2 ...}}" } ], "tldr_source": "official", "flags": [ { "flag": "-B", "long": null, "arg": null, "description": "poses." }, { "flag": "-b", "long": null, "arg": null, "description": "Use blocksize in bytes, or with [KMG] suffix, up to 1GB for output instead of the file system blocksize. For compatibility with earlier versions of filefrag, if blocksize is unspecified it defaults to 1024 bytes. Since blocksize is an optional argument, it must be added without any space after -b." }, { "flag": "-e", "long": null, "arg": null, "description": "" }, { "flag": "-E", "long": null, "arg": null, "description": "all kernels, and is only supported on ext4 file systems." }, { "flag": "-k", "long": null, "arg": null, "description": "" }, { "flag": "-P", "long": null, "arg": null, "description": "nels, and is only supported on ext4 file systems." }, { "flag": "-s", "long": null, "arg": null, "description": "" }, { "flag": "-v", "long": null, "arg": null, "description": "" }, { "flag": "-V", "long": null, "arg": null, "description": "flags that are understood by the current version." }, { "flag": "-x", "long": null, "arg": null, "description": "" }, { "flag": "-X", "long": null, "arg": null, "description": "" } ], "examples": [], "see_also": [], "section_outline": [ { "name": "NAME", "lines": 2, "subsections": [] }, { "name": "SYNOPSIS", "lines": 2, "subsections": [] }, { "name": "DESCRIPTION", "lines": 7, "subsections": [] }, { "name": "OPTIONS", "lines": 1, "subsections": [ { "name": "-B", "lines": 2, "flag": "-B" }, { "name": "-b", "lines": 5, "flag": "-b" }, { "name": "-e", "lines": 1, "flag": "-e" }, { "name": "-E", "lines": 2, "flag": "-E" }, { "name": "-k", "lines": 1, "flag": "-k" }, { "name": "-P", "lines": 2, "flag": "-P" }, { "name": "-s", "lines": 1, "flag": "-s" }, { "name": "-v", "lines": 1, "flag": "-v" }, { "name": "-V", "lines": 2, "flag": "-V" }, { "name": "-x", "lines": 1, "flag": "-x" }, { "name": "-X", "lines": 1, "flag": "-X" } ] }, { "name": "AUTHOR", "lines": 5, "subsections": [] } ] } }