projects / thirdparty / e2fsprogs.git / blame
| Commit | Line | Data |
|---|---|---|
| 96424130 TT |
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 | [ | |
| 2508eaa7 AD |
8 | .BI \-b blocksize |
| 9 | ] | |
| 10 | [ | |
| 612358c1 | 11 | .B \-BeEkPsvVxX |
| 96424130 TT |
12 | ] |
| 13 | [ | |
| 14 | .I files... | |
| 15 | ] | |
| 16 | .SH DESCRIPTION | |
| 17 | .B filefrag | |
| d04ad325 | 18 | reports on how badly fragmented a particular file might be. It makes |
| e87bb84b TT |
19 | allowances for indirect blocks for ext2 and ext3 file systems, but can be |
| 20 | used on files for any file system. | |
| e62847c5 | 21 | .PP |
| d04ad325 | 22 | The |
| e62847c5 KS |
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. | |
| 96424130 TT |
27 | .SH OPTIONS |
| 28 | .TP | |
| 5d5e01d7 TT |
29 | .B \-B |
| 30 | Force the use of the older FIBMAP ioctl instead of the FIEMAP ioctl for | |
| 31 | testing purposes. | |
| 32 | .TP | |
| 2508eaa7 AD |
33 | .BI \-b blocksize |
| 34 | Use | |
| 35 | .I blocksize | |
| e08226c7 | 36 | in bytes, or with [KMG] suffix, up to 1GB for output instead of the |
| e87bb84b | 37 | file system blocksize. For compatibility with earlier versions of |
| 2508eaa7 AD |
38 | .BR filefrag , |
| 39 | if | |
| 40 | .I blocksize | |
| 612358c1 AD |
41 | is unspecified it defaults to 1024 bytes. Since |
| 42 | .I blocksize | |
| 43 | is an optional argument, it must be added without any space after | |
| 44 | .BR -b . | |
| 2508eaa7 AD |
45 | .TP |
| 46 | .B \-e | |
| 47 | Print output in extent format, even for block-mapped files. | |
| 48 | .TP | |
| a320a1c6 TT |
49 | .B \-E |
| 50 | Display the contents of ext4's extent status cache. This feature is not | |
| 51 | supported on all kernels, and is only supported on ext4 file systems. | |
| 52 | .TP | |
| 612358c1 AD |
53 | .B \-k |
| 54 | Use 1024\-byte blocksize for output (identical to '\-b1024'). | |
| a320a1c6 TT |
55 | .TP |
| 56 | .B -P | |
| 612358c1 | 57 | Pre-load the ext4 extent status cache for the file. This is not |
| e87bb84b | 58 | supported on all kernels, and is only supported on ext4 file systems. |
| e62847c5 KS |
59 | .TP |
| 60 | .B \-s | |
| 61 | Sync the file before requesting the mapping. | |
| 62 | .TP | |
| 96424130 TT |
63 | .B \-v |
| 64 | Be verbose when checking for file fragmentation. | |
| e62847c5 | 65 | .TP |
| 612358c1 AD |
66 | .B \-V |
| 67 | Print version number of program and library. If given twice, also | |
| 68 | print the FIEMAP flags that are understood by the current version. | |
| 69 | .TP | |
| e62847c5 KS |
70 | .B \-x |
| 71 | Display mapping of extended attributes. | |
| 2508eaa7 AD |
72 | .TP |
| 73 | .B \-X | |
| 74 | Display extent block numbers in hexadecimal format. | |
| 96424130 TT |
75 | .SH AUTHOR |
| 76 | .B filefrag | |
| 77 | was written by Theodore Ts'o <tytso@mit.edu>. |