filefrag(8) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | AUTHOR | COLOPHON

FILEFRAG(8)              System Manager's Manual             FILEFRAG(8)

NAME         top

       filefrag - report on file fragmentation

SYNOPSIS         top

       filefrag [ -bblocksize ] [ -BeEkPsvVxX ] [ files...  ]

DESCRIPTION         top

       filefrag reports on how badly fragmented a particular file might
       be.  It makes allowances for indirect blocks for ext2 and ext3
       file systems, but can be used on files for any file system.

       The filefrag program initially attempts to get the extent
       information using FIEMAP ioctl which is more efficient and
       faster.  If FIEMAP is not supported then filefrag will fall back
       to using FIBMAP.

OPTIONS         top

       -B     Force the use of the older FIBMAP ioctl instead of the
              FIEMAP ioctl for testing purposes.

       -bblocksize
              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.

       -e     Print output in extent format, even for block-mapped
              files.

       -E     Display the contents of ext4's extent status cache.  This
              feature is not supported on all kernels, and is only
              supported on ext4 file systems.

       -k     Use 1024-byte blocksize for output (identical to
              '-b1024').

       -P     Pre-load the ext4 extent status cache for the file.  This
              is not supported on all kernels, and is only supported on
              ext4 file systems.

       -s     Sync the file before requesting the mapping.

       -v     Be verbose when checking for file fragmentation.

       -V     Print version number of program and library.  If given
              twice, also print the FIEMAP flags that are understood by
              the current version.

       -x     Display mapping of extended attributes.

       -X     Display extent block numbers in hexadecimal format.

AUTHOR         top

       filefrag was written by Theodore Ts'o <tytso@mit.edu>.

COLOPHON         top

       This page is part of the e2fsprogs (utilities for ext2/3/4
       filesystems) project.  Information about the project can be found
       at ⟨http://e2fsprogs.sourceforge.net/⟩.  It is not known how to
       report bugs for this man page; if you know, please send a mail to
       man-pages@man7.org.  This page was obtained from the project's
       upstream Git repository
       ⟨git://git.kernel.org/pub/scm/fs/ext2/e2fsprogs.git⟩ on
       2023-12-22.  (At that time, the date of the most recent commit
       that was found in the repository was 2023-12-07.)  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 to man-pages@man7.org

E2fsprogs version 1.47.0      February 2023                  FILEFRAG(8)