summaryrefslogtreecommitdiffstats
path: root/misc/filefrag.8.in
blob: 6d56c130b664c0cce762fd66b77f9d389394d0b0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
.\" -*- nroff -*-
.TH FILEFRAG 8 "@E2FSPROGS_MONTH@ @E2FSPROGS_YEAR@" "E2fsprogs version @E2FSPROGS_VERSION@"
.SH NAME
filefrag \- report on file fragmentation
.SH SYNOPSIS
.B filefrag
[
.BI \-b blocksize
]
[
.B \-BeEkPsvVxX
]
[
.I files...
]
.SH DESCRIPTION
.B 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.
.PP
The
.B 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.
.SH OPTIONS
.TP
.B \-B
Force the use of the older FIBMAP ioctl instead of the FIEMAP ioctl for
testing purposes.
.TP
.BI \-b blocksize
Use
.I blocksize
in bytes, or with [KMG] suffix, up to 1GB for output instead of the
file system blocksize.  For compatibility with earlier versions of
.BR filefrag ,
if
.I blocksize
is unspecified it defaults to 1024 bytes.  Since
.I blocksize
is an optional argument, it must be added without any space after
.BR -b .
.TP
.B \-e
Print output in extent format, even for block-mapped files.
.TP
.B \-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.
.TP
.B \-k
Use 1024\-byte blocksize for output (identical to '\-b1024').
.TP
.B -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.
.TP
.B \-s
Sync the file before requesting the mapping.
.TP
.B \-v
Be verbose when checking for file fragmentation.
.TP
.B \-V
Print version number of program and library.  If given twice, also
print the FIEMAP flags that are understood by the current version.
.TP
.B \-x
Display mapping of extended attributes.
.TP
.B \-X
Display extent block numbers in hexadecimal format.
.SH AUTHOR
.B filefrag
was written by Theodore Ts'o <tytso@mit.edu>.