misc/filefrag.8.in

   1 .\" -*- nroff -*-
   2 .TH FILEFRAG 8 "@E2FSPROGS_MONTH@ @E2FSPROGS_YEAR@" "E2fsprogs version @E2FSPROGS_VERSION@"
   3 .SH NAME
   4 filefrag \- report on file fragmentation
   5 .SH SYNOPSIS
   6 .B filefrag
   7 [
   8 .BI \-b blocksize
   9 ]
  10 [
  11 .B \-BeksvxX
  12 ]
  13 [
  14 .I files...
  15 ]
  16 .SH DESCRIPTION
  17 .B filefrag
  18 reports on how badly fragmented a particular file might be.  It makes
  19 allowances for indirect blocks for ext2 and ext3 filesystems, but can be
  20 used on files for any filesystem.
  21 .PP
  22 The
  23 .B filefrag
  24 program initially attempts to get the
  25 extent information using FIEMAP ioctl which is more efficient and faster.
  26 If FIEMAP is not supported then filefrag will fall back to using FIBMAP.
  27 .SH OPTIONS
  28 .TP
  29 .B \-B
  30 Force the use of the older FIBMAP ioctl instead of the FIEMAP ioctl for
  31 testing purposes.
  32 .TP
  33 .BI \-b blocksize
  34 Use
  35 .I blocksize
  36 in bytes for output instead of the filesystem blocksize.
  37 For compatibility with earlier versions of
  38 .BR filefrag ,
  39 if
  40 .I blocksize
  41 is unspecified it defaults to 1024 bytes.
  42 .TP
  43 .B \-e
  44 Print output in extent format, even for block-mapped files.
  45 .TP
  46 .BI \-k
  47 Use 1024\-byte blocksize for output (identical to '\-b 1024').
  48 .TP
  49 .B \-s
  50 Sync the file before requesting the mapping.
  51 .TP
  52 .B \-v
  53 Be verbose when checking for file fragmentation.
  54 .TP
  55 .B \-x
  56 Display mapping of extended attributes.
  57 .TP
  58 .B \-X
  59 Display extent block numbers in hexadecimal format.
  60 .SH AUTHOR
  61 .B filefrag
  62 was written by Theodore Ts'o <tytso@mit.edu>.