1 What: /sys/fs/f2fs/<disk>/gc_max_sle 1 What: /sys/fs/f2fs/<disk>/gc_max_sleep_time
2 Date: July 2013 2 Date: July 2013
3 Contact: "Namjae Jeon" <namjae.jeon@sams 3 Contact: "Namjae Jeon" <namjae.jeon@samsung.com>
4 Description: Controls the maximum sleep tim 4 Description: Controls the maximum sleep time for gc_thread. Time
5 is in milliseconds. 5 is in milliseconds.
6 6
7 What: /sys/fs/f2fs/<disk>/gc_min_sle 7 What: /sys/fs/f2fs/<disk>/gc_min_sleep_time
8 Date: July 2013 8 Date: July 2013
9 Contact: "Namjae Jeon" <namjae.jeon@sams 9 Contact: "Namjae Jeon" <namjae.jeon@samsung.com>
10 Description: Controls the minimum sleep tim 10 Description: Controls the minimum sleep time for gc_thread. Time
11 is in milliseconds. 11 is in milliseconds.
12 12
13 What: /sys/fs/f2fs/<disk>/gc_no_gc_s 13 What: /sys/fs/f2fs/<disk>/gc_no_gc_sleep_time
14 Date: July 2013 14 Date: July 2013
15 Contact: "Namjae Jeon" <namjae.jeon@sams 15 Contact: "Namjae Jeon" <namjae.jeon@samsung.com>
16 Description: Controls the default sleep tim 16 Description: Controls the default sleep time for gc_thread. Time
17 is in milliseconds. 17 is in milliseconds.
18 18
19 What: /sys/fs/f2fs/<disk>/gc_idle 19 What: /sys/fs/f2fs/<disk>/gc_idle
20 Date: July 2013 20 Date: July 2013
21 Contact: "Namjae Jeon" <namjae.jeon@sams 21 Contact: "Namjae Jeon" <namjae.jeon@samsung.com>
22 Description: Controls the victim selection 22 Description: Controls the victim selection policy for garbage collection.
23 Setting gc_idle = 0(default) w 23 Setting gc_idle = 0(default) will disable this option. Setting:
24 24
25 =========== ================= 25 =========== ===============================================
26 gc_idle = 1 will select the C 26 gc_idle = 1 will select the Cost Benefit approach & setting
27 gc_idle = 2 will select the g 27 gc_idle = 2 will select the greedy approach & setting
28 gc_idle = 3 will select the a 28 gc_idle = 3 will select the age-threshold based approach.
29 =========== ================= 29 =========== ===============================================
30 30
31 What: /sys/fs/f2fs/<disk>/reclaim_se 31 What: /sys/fs/f2fs/<disk>/reclaim_segments
32 Date: October 2013 32 Date: October 2013
33 Contact: "Jaegeuk Kim" <jaegeuk.kim@sams 33 Contact: "Jaegeuk Kim" <jaegeuk.kim@samsung.com>
34 Description: This parameter controls the nu 34 Description: This parameter controls the number of prefree segments to be
35 reclaimed. If the number of pr 35 reclaimed. If the number of prefree segments is larger than
36 the number of segments in the 36 the number of segments in the proportion to the percentage
37 over total volume size, f2fs t 37 over total volume size, f2fs tries to conduct checkpoint to
38 reclaim the prefree segments t 38 reclaim the prefree segments to free segments.
39 By default, 5% over total # of 39 By default, 5% over total # of segments.
40 40
41 What: /sys/fs/f2fs/<disk>/main_blkad 41 What: /sys/fs/f2fs/<disk>/main_blkaddr
42 Date: November 2019 42 Date: November 2019
43 Contact: "Ramon Pantin" <pantin@google.c 43 Contact: "Ramon Pantin" <pantin@google.com>
44 Description: Shows first block address of M 44 Description: Shows first block address of MAIN area.
45 45
46 What: /sys/fs/f2fs/<disk>/ipu_policy 46 What: /sys/fs/f2fs/<disk>/ipu_policy
47 Date: November 2013 47 Date: November 2013
48 Contact: "Jaegeuk Kim" <jaegeuk.kim@sams 48 Contact: "Jaegeuk Kim" <jaegeuk.kim@samsung.com>
49 Description: Controls the in-place-update p 49 Description: Controls the in-place-update policy.
50 updates in f2fs. User can set: 50 updates in f2fs. User can set:
51 51
52 ===== =============== ======== !! 52 ==== =================
53 value policy descript !! 53 0x01 F2FS_IPU_FORCE
54 0x00 DISABLE disable !! 54 0x02 F2FS_IPU_SSR
55 0x01 FORCE all the !! 55 0x04 F2FS_IPU_UTIL
56 0x02 SSR if SSR m !! 56 0x08 F2FS_IPU_SSR_UTIL
57 0x04 UTIL if FS ut !! 57 0x10 F2FS_IPU_FSYNC
58 0x08 SSR_UTIL if SSR m !! 58 0x20 F2FS_IPU_ASYNC,
59 threshol !! 59 0x40 F2FS_IPU_NOCACHE
60 0x10 FSYNC activate !! 60 ==== =================
61 flash st <<
62 # of dir <<
63 (=defaul <<
64 0x20 ASYNC do IPU g <<
65 0x40 NOCACHE disable <<
66 0x80 HONOR_OPU_WRITE use OPU <<
67 FI_OPU_W <<
68 ===== =============== ======== <<
69 61
70 Refer segment.h for details. 62 Refer segment.h for details.
71 63
72 What: /sys/fs/f2fs/<disk>/min_ipu_ut 64 What: /sys/fs/f2fs/<disk>/min_ipu_util
73 Date: November 2013 65 Date: November 2013
74 Contact: "Jaegeuk Kim" <jaegeuk.kim@sams 66 Contact: "Jaegeuk Kim" <jaegeuk.kim@samsung.com>
75 Description: Controls the FS utilization co 67 Description: Controls the FS utilization condition for the in-place-update
76 policies. It is used by F2FS_I 68 policies. It is used by F2FS_IPU_UTIL and F2FS_IPU_SSR_UTIL policies.
77 69
78 What: /sys/fs/f2fs/<disk>/min_fsync_ 70 What: /sys/fs/f2fs/<disk>/min_fsync_blocks
79 Date: September 2014 71 Date: September 2014
80 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o 72 Contact: "Jaegeuk Kim" <jaegeuk@kernel.org>
81 Description: Controls the dirty page count 73 Description: Controls the dirty page count condition for the in-place-update
82 policies. 74 policies.
83 75
84 What: /sys/fs/f2fs/<disk>/min_seq_bl 76 What: /sys/fs/f2fs/<disk>/min_seq_blocks
85 Date: August 2018 77 Date: August 2018
86 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o 78 Contact: "Jaegeuk Kim" <jaegeuk@kernel.org>
87 Description: Controls the dirty page count 79 Description: Controls the dirty page count condition for batched sequential
88 writes in writepages. 80 writes in writepages.
89 81
90 What: /sys/fs/f2fs/<disk>/min_hot_bl 82 What: /sys/fs/f2fs/<disk>/min_hot_blocks
91 Date: March 2017 83 Date: March 2017
92 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o 84 Contact: "Jaegeuk Kim" <jaegeuk@kernel.org>
93 Description: Controls the dirty page count 85 Description: Controls the dirty page count condition for redefining hot data.
94 86
95 What: /sys/fs/f2fs/<disk>/min_ssr_se 87 What: /sys/fs/f2fs/<disk>/min_ssr_sections
96 Date: October 2017 88 Date: October 2017
97 Contact: "Chao Yu" <yuchao0@huawei.com> 89 Contact: "Chao Yu" <yuchao0@huawei.com>
98 Description: Controls the free section thre 90 Description: Controls the free section threshold to trigger SSR allocation.
99 If this is large, SSR mode wil 91 If this is large, SSR mode will be enabled early.
100 92
101 What: /sys/fs/f2fs/<disk>/max_small_ 93 What: /sys/fs/f2fs/<disk>/max_small_discards
102 Date: November 2013 94 Date: November 2013
103 Contact: "Jaegeuk Kim" <jaegeuk.kim@sams 95 Contact: "Jaegeuk Kim" <jaegeuk.kim@samsung.com>
104 Description: Controls the issue rate of dis 96 Description: Controls the issue rate of discard commands that consist of small
105 blocks less than 2MB. The cand !! 97 blocks less than 2MB. The candidates to be discarded are cached until
106 checkpoint, and issued by issu !! 98 checkpoint is triggered, and issued during the checkpoint.
107 It is enabled by default. !! 99 By default, it is disabled with 0.
108 <<
109 What: /sys/fs/f2fs/<disk>/max_ordere <<
110 Date: October 2022 <<
111 Contact: "Yangtao Li" <frank.li@vivo.com <<
112 Description: Controls the maximum ordered d <<
113 Set it to 16 by default. <<
114 <<
115 What: /sys/fs/f2fs/<disk>/max_discar <<
116 Date: December 2021 <<
117 Contact: "Konstantin Vyshetsky" <vkon@go <<
118 Description: Controls the number of discard <<
119 Higher number will allow the d <<
120 faster, at the cost of higher <<
121 <<
122 What: /sys/fs/f2fs/<disk>/min_discar <<
123 Date: December 2021 <<
124 Contact: "Konstantin Vyshetsky" <vkon@go <<
125 Description: Controls the interval the disc <<
126 issuing discard requests when <<
127 no I/O aware interruptions occ <<
128 <<
129 What: /sys/fs/f2fs/<disk>/mid_discar <<
130 Date: December 2021 <<
131 Contact: "Konstantin Vyshetsky" <vkon@go <<
132 Description: Controls the interval the disc <<
133 issuing discard requests when <<
134 an I/O aware interruption occu <<
135 <<
136 What: /sys/fs/f2fs/<disk>/max_discar <<
137 Date: December 2021 <<
138 Contact: "Konstantin Vyshetsky" <vkon@go <<
139 Description: Controls the interval the disc <<
140 no discard operations to be is <<
141 100
142 What: /sys/fs/f2fs/<disk>/discard_gr 101 What: /sys/fs/f2fs/<disk>/discard_granularity
143 Date: July 2017 102 Date: July 2017
144 Contact: "Chao Yu" <yuchao0@huawei.com> 103 Contact: "Chao Yu" <yuchao0@huawei.com>
145 Description: Controls discard granularity o 104 Description: Controls discard granularity of inner discard thread. Inner thread
146 will not issue discards with s 105 will not issue discards with size that is smaller than granularity.
147 The unit size is one block(4KB 106 The unit size is one block(4KB), now only support configuring
148 in range of [1, 512]. Default !! 107 in range of [1, 512]. Default value is 4(=16KB).
149 For small devices, default val <<
150 108
151 What: /sys/fs/f2fs/<disk>/umount_dis 109 What: /sys/fs/f2fs/<disk>/umount_discard_timeout
152 Date: January 2019 110 Date: January 2019
153 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o 111 Contact: "Jaegeuk Kim" <jaegeuk@kernel.org>
154 Description: Set timeout to issue discard c 112 Description: Set timeout to issue discard commands during umount.
155 Default: 5 secs 113 Default: 5 secs
156 114
157 What: /sys/fs/f2fs/<disk>/pending_di <<
158 Date: November 2021 <<
159 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o <<
160 Description: Shows the number of pending di <<
161 <<
162 What: /sys/fs/f2fs/<disk>/max_victim 115 What: /sys/fs/f2fs/<disk>/max_victim_search
163 Date: January 2014 116 Date: January 2014
164 Contact: "Jaegeuk Kim" <jaegeuk.kim@sams 117 Contact: "Jaegeuk Kim" <jaegeuk.kim@samsung.com>
165 Description: Controls the number of trials 118 Description: Controls the number of trials to find a victim segment
166 when conducting SSR and cleani 119 when conducting SSR and cleaning operations. The default value
167 is 4096 which covers 8GB block 120 is 4096 which covers 8GB block address range.
168 121
169 What: /sys/fs/f2fs/<disk>/migration_ 122 What: /sys/fs/f2fs/<disk>/migration_granularity
170 Date: October 2018 123 Date: October 2018
171 Contact: "Chao Yu" <yuchao0@huawei.com> 124 Contact: "Chao Yu" <yuchao0@huawei.com>
172 Description: Controls migration granularity 125 Description: Controls migration granularity of garbage collection on large
173 section, it can let GC move pa 126 section, it can let GC move partial segment{s} of one section
174 in one GC cycle, so that dispe 127 in one GC cycle, so that dispersing heavy overhead GC to
175 multiple lightweight one. 128 multiple lightweight one.
176 129
177 What: /sys/fs/f2fs/<disk>/dir_level 130 What: /sys/fs/f2fs/<disk>/dir_level
178 Date: March 2014 131 Date: March 2014
179 Contact: "Jaegeuk Kim" <jaegeuk.kim@sams 132 Contact: "Jaegeuk Kim" <jaegeuk.kim@samsung.com>
180 Description: Controls the directory level f 133 Description: Controls the directory level for large directory. If a
181 directory has a number of file 134 directory has a number of files, it can reduce the file lookup
182 latency by increasing this dir 135 latency by increasing this dir_level value. Otherwise, it
183 needs to decrease this value t 136 needs to decrease this value to reduce the space overhead.
184 The default value is 0. 137 The default value is 0.
185 138
186 What: /sys/fs/f2fs/<disk>/ram_thresh 139 What: /sys/fs/f2fs/<disk>/ram_thresh
187 Date: March 2014 140 Date: March 2014
188 Contact: "Jaegeuk Kim" <jaegeuk.kim@sams 141 Contact: "Jaegeuk Kim" <jaegeuk.kim@samsung.com>
189 Description: Controls the memory footprint 142 Description: Controls the memory footprint used by free nids and cached
190 nat entries. By default, 1 is 143 nat entries. By default, 1 is set, which indicates
191 10 MB / 1 GB RAM. 144 10 MB / 1 GB RAM.
192 145
>> 146 What: /sys/fs/f2fs/<disk>/batched_trim_sections
>> 147 Date: February 2015
>> 148 Contact: "Jaegeuk Kim" <jaegeuk@kernel.org>
>> 149 Description: Controls the trimming rate in batch mode.
>> 150 <deprecated>
>> 151
193 What: /sys/fs/f2fs/<disk>/cp_interva 152 What: /sys/fs/f2fs/<disk>/cp_interval
194 Date: October 2015 153 Date: October 2015
195 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o 154 Contact: "Jaegeuk Kim" <jaegeuk@kernel.org>
196 Description: Controls the checkpoint timing 155 Description: Controls the checkpoint timing, set to 60 seconds by default.
197 156
198 What: /sys/fs/f2fs/<disk>/idle_inter 157 What: /sys/fs/f2fs/<disk>/idle_interval
199 Date: January 2016 158 Date: January 2016
200 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o 159 Contact: "Jaegeuk Kim" <jaegeuk@kernel.org>
201 Description: Controls the idle timing of sy 160 Description: Controls the idle timing of system, if there is no FS operation
202 during given interval. 161 during given interval.
203 Set to 5 seconds by default. 162 Set to 5 seconds by default.
204 163
205 What: /sys/fs/f2fs/<disk>/discard_id 164 What: /sys/fs/f2fs/<disk>/discard_idle_interval
206 Date: September 2018 165 Date: September 2018
207 Contact: "Chao Yu" <yuchao0@huawei.com> 166 Contact: "Chao Yu" <yuchao0@huawei.com>
208 Contact: "Sahitya Tummala" <quic_stummal !! 167 Contact: "Sahitya Tummala" <stummala@codeaurora.org>
209 Description: Controls the idle timing of di 168 Description: Controls the idle timing of discard thread given
210 this time interval. 169 this time interval.
211 Default is 5 secs. 170 Default is 5 secs.
212 171
213 What: /sys/fs/f2fs/<disk>/gc_idle_in 172 What: /sys/fs/f2fs/<disk>/gc_idle_interval
214 Date: September 2018 173 Date: September 2018
215 Contact: "Chao Yu" <yuchao0@huawei.com> 174 Contact: "Chao Yu" <yuchao0@huawei.com>
216 Contact: "Sahitya Tummala" <quic_stummal !! 175 Contact: "Sahitya Tummala" <stummala@codeaurora.org>
217 Description: Controls the idle timing for g 176 Description: Controls the idle timing for gc path. Set to 5 seconds by default.
218 177
219 What: /sys/fs/f2fs/<disk>/iostat_ena 178 What: /sys/fs/f2fs/<disk>/iostat_enable
220 Date: August 2017 179 Date: August 2017
221 Contact: "Chao Yu" <yuchao0@huawei.com> 180 Contact: "Chao Yu" <yuchao0@huawei.com>
222 Description: Controls to enable/disable IO 181 Description: Controls to enable/disable IO stat.
223 182
224 What: /sys/fs/f2fs/<disk>/ra_nid_pag 183 What: /sys/fs/f2fs/<disk>/ra_nid_pages
225 Date: October 2015 184 Date: October 2015
226 Contact: "Chao Yu" <chao2.yu@samsung.com 185 Contact: "Chao Yu" <chao2.yu@samsung.com>
227 Description: Controls the count of nid page 186 Description: Controls the count of nid pages to be readaheaded.
228 When building free nids, F2FS 187 When building free nids, F2FS reads NAT blocks ahead for
229 speed up. Default is 0. 188 speed up. Default is 0.
230 189
231 What: /sys/fs/f2fs/<disk>/dirty_nats 190 What: /sys/fs/f2fs/<disk>/dirty_nats_ratio
232 Date: January 2016 191 Date: January 2016
233 Contact: "Chao Yu" <chao2.yu@samsung.com 192 Contact: "Chao Yu" <chao2.yu@samsung.com>
234 Description: Controls dirty nat entries rat 193 Description: Controls dirty nat entries ratio threshold, if current
235 ratio exceeds configured thres 194 ratio exceeds configured threshold, checkpoint will
236 be triggered for flushing dirt 195 be triggered for flushing dirty nat entries.
237 196
238 What: /sys/fs/f2fs/<disk>/lifetime_w 197 What: /sys/fs/f2fs/<disk>/lifetime_write_kbytes
239 Date: January 2016 198 Date: January 2016
240 Contact: "Shuoran Liu" <liushuoran@huawe 199 Contact: "Shuoran Liu" <liushuoran@huawei.com>
241 Description: Shows total written kbytes iss 200 Description: Shows total written kbytes issued to disk.
242 201
243 What: /sys/fs/f2fs/<disk>/features 202 What: /sys/fs/f2fs/<disk>/features
244 Date: July 2017 203 Date: July 2017
245 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o 204 Contact: "Jaegeuk Kim" <jaegeuk@kernel.org>
246 Description: <deprecated: should use /sys/f !! 205 Description: <deprecated: should use /sys/fs/f2fs/<disk>/feature_list/
247 Shows all enabled features in 206 Shows all enabled features in current device.
248 Supported features: 207 Supported features:
249 encryption, blkzoned, extra_at 208 encryption, blkzoned, extra_attr, projquota, inode_checksum,
250 flexible_inline_xattr, quota_i 209 flexible_inline_xattr, quota_ino, inode_crtime, lost_found,
251 verity, sb_checksum, casefold, 210 verity, sb_checksum, casefold, readonly, compression, pin_file.
252 211
253 What: /sys/fs/f2fs/<disk>/feature_li 212 What: /sys/fs/f2fs/<disk>/feature_list/
254 Date: June 2021 213 Date: June 2021
255 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o 214 Contact: "Jaegeuk Kim" <jaegeuk@kernel.org>
256 Description: Expand /sys/fs/f2fs/<disk>/fea 215 Description: Expand /sys/fs/f2fs/<disk>/features to meet sysfs rule.
257 Supported on-disk features: 216 Supported on-disk features:
258 encryption, block_zoned (aka b 217 encryption, block_zoned (aka blkzoned), extra_attr,
259 project_quota (aka projquota), 218 project_quota (aka projquota), inode_checksum,
260 flexible_inline_xattr, quota_i 219 flexible_inline_xattr, quota_ino, inode_crtime, lost_found,
261 verity, sb_checksum, casefold, 220 verity, sb_checksum, casefold, readonly, compression.
262 Note that, pin_file is moved i 221 Note that, pin_file is moved into /sys/fs/f2fs/features/.
263 222
264 What: /sys/fs/f2fs/features/ 223 What: /sys/fs/f2fs/features/
265 Date: July 2017 224 Date: July 2017
266 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o 225 Contact: "Jaegeuk Kim" <jaegeuk@kernel.org>
267 Description: Shows all enabled kernel featu 226 Description: Shows all enabled kernel features.
268 Supported features: 227 Supported features:
269 encryption, block_zoned, extra 228 encryption, block_zoned, extra_attr, project_quota,
270 inode_checksum, flexible_inlin 229 inode_checksum, flexible_inline_xattr, quota_ino,
271 inode_crtime, lost_found, veri 230 inode_crtime, lost_found, verity, sb_checksum,
272 casefold, readonly, compressio 231 casefold, readonly, compression, test_dummy_encryption_v2,
273 atomic_write, pin_file, encryp 232 atomic_write, pin_file, encrypted_casefold.
274 233
275 What: /sys/fs/f2fs/<disk>/inject_rat 234 What: /sys/fs/f2fs/<disk>/inject_rate
276 Date: May 2016 235 Date: May 2016
277 Contact: "Sheng Yong" <shengyong1@huawei 236 Contact: "Sheng Yong" <shengyong1@huawei.com>
278 Description: Controls the injection rate of 237 Description: Controls the injection rate of arbitrary faults.
279 238
280 What: /sys/fs/f2fs/<disk>/inject_typ 239 What: /sys/fs/f2fs/<disk>/inject_type
281 Date: May 2016 240 Date: May 2016
282 Contact: "Sheng Yong" <shengyong1@huawei 241 Contact: "Sheng Yong" <shengyong1@huawei.com>
283 Description: Controls the injection type of 242 Description: Controls the injection type of arbitrary faults.
284 243
285 What: /sys/fs/f2fs/<disk>/dirty_segm 244 What: /sys/fs/f2fs/<disk>/dirty_segments
286 Date: October 2017 245 Date: October 2017
287 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o 246 Contact: "Jaegeuk Kim" <jaegeuk@kernel.org>
288 Description: Shows the number of dirty segm 247 Description: Shows the number of dirty segments.
289 248
290 What: /sys/fs/f2fs/<disk>/reserved_b 249 What: /sys/fs/f2fs/<disk>/reserved_blocks
291 Date: June 2017 250 Date: June 2017
292 Contact: "Chao Yu" <yuchao0@huawei.com> 251 Contact: "Chao Yu" <yuchao0@huawei.com>
293 Description: Controls target reserved block 252 Description: Controls target reserved blocks in system, the threshold
294 is soft, it could exceed curre 253 is soft, it could exceed current available user space.
295 254
296 What: /sys/fs/f2fs/<disk>/current_re 255 What: /sys/fs/f2fs/<disk>/current_reserved_blocks
297 Date: October 2017 256 Date: October 2017
298 Contact: "Yunlong Song" <yunlong.song@hu 257 Contact: "Yunlong Song" <yunlong.song@huawei.com>
299 Contact: "Chao Yu" <yuchao0@huawei.com> 258 Contact: "Chao Yu" <yuchao0@huawei.com>
300 Description: Shows current reserved blocks 259 Description: Shows current reserved blocks in system, it may be temporarily
301 smaller than target_reserved_b 260 smaller than target_reserved_blocks, but will gradually
302 increase to target_reserved_bl 261 increase to target_reserved_blocks when more free blocks are
303 freed by user later. 262 freed by user later.
304 263
305 What: /sys/fs/f2fs/<disk>/gc_urgent 264 What: /sys/fs/f2fs/<disk>/gc_urgent
306 Date: August 2017 265 Date: August 2017
307 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o 266 Contact: "Jaegeuk Kim" <jaegeuk@kernel.org>
308 Description: Do background GC aggressively !! 267 Description: Do background GC aggressively when set. When gc_urgent = 1,
309 gc urgent high(1): does GC for !! 268 background thread starts to do GC by given gc_urgent_sleep_time
310 gc_urgent_sleep_time and ignor !! 269 interval. When gc_urgent = 2, F2FS will lower the bar of
311 GC approach and turns SSR mode !! 270 checking idle in order to process outstanding discard commands
312 gc urgent low(2): lowers the b !! 271 and GC a little bit aggressively. It is set to 0 by default.
313 order to process outstanding d <<
314 little bit aggressively. uses <<
315 gc urgent mid(3): does GC forc <<
316 gc_urgent_sleep_time and execu <<
317 uses cost benefit GC approach. <<
318 272
319 What: /sys/fs/f2fs/<disk>/gc_urgent_ 273 What: /sys/fs/f2fs/<disk>/gc_urgent_sleep_time
320 Date: August 2017 274 Date: August 2017
321 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o 275 Contact: "Jaegeuk Kim" <jaegeuk@kernel.org>
322 Description: Controls sleep time of GC urge 276 Description: Controls sleep time of GC urgent mode. Set to 500ms by default.
323 277
324 What: /sys/fs/f2fs/<disk>/readdir_ra 278 What: /sys/fs/f2fs/<disk>/readdir_ra
325 Date: November 2017 279 Date: November 2017
326 Contact: "Sheng Yong" <shengyong1@huawei 280 Contact: "Sheng Yong" <shengyong1@huawei.com>
327 Description: Controls readahead inode block 281 Description: Controls readahead inode block in readdir. Enabled by default.
328 282
329 What: /sys/fs/f2fs/<disk>/gc_pin_fil 283 What: /sys/fs/f2fs/<disk>/gc_pin_file_thresh
330 Date: January 2018 284 Date: January 2018
331 Contact: Jaegeuk Kim <jaegeuk@kernel.org 285 Contact: Jaegeuk Kim <jaegeuk@kernel.org>
332 Description: This indicates how many GC can 286 Description: This indicates how many GC can be failed for the pinned
333 file. If it exceeds this, F2FS 287 file. If it exceeds this, F2FS doesn't guarantee its pinning
334 state. 2048 trials is set by d !! 288 state. 2048 trials is set by default.
335 289
336 What: /sys/fs/f2fs/<disk>/extension_ 290 What: /sys/fs/f2fs/<disk>/extension_list
337 Date: February 2018 !! 291 Date: Feburary 2018
338 Contact: "Chao Yu" <yuchao0@huawei.com> 292 Contact: "Chao Yu" <yuchao0@huawei.com>
339 Description: Used to control configure exte 293 Description: Used to control configure extension list:
340 - Query: cat /sys/fs/f2fs/<dis 294 - Query: cat /sys/fs/f2fs/<disk>/extension_list
341 - Add: echo '[h/c]extension' > 295 - Add: echo '[h/c]extension' > /sys/fs/f2fs/<disk>/extension_list
342 - Del: echo '[h/c]!extension' 296 - Del: echo '[h/c]!extension' > /sys/fs/f2fs/<disk>/extension_list
343 - [h] means add/del hot file e 297 - [h] means add/del hot file extension
344 - [c] means add/del cold file 298 - [c] means add/del cold file extension
345 299
346 What: /sys/fs/f2fs/<disk>/unusable 300 What: /sys/fs/f2fs/<disk>/unusable
347 Date April 2019 301 Date April 2019
348 Contact: "Daniel Rosenberg" <drosen@goog 302 Contact: "Daniel Rosenberg" <drosen@google.com>
349 Description: If checkpoint=disable, it disp 303 Description: If checkpoint=disable, it displays the number of blocks that
350 are unusable. 304 are unusable.
351 If checkpoint=enable it displa 305 If checkpoint=enable it displays the number of blocks that
352 would be unusable if checkpoin 306 would be unusable if checkpoint=disable were to be set.
353 307
354 What: /sys/fs/f2fs/<disk>/encoding 308 What: /sys/fs/f2fs/<disk>/encoding
355 Date July 2019 309 Date July 2019
356 Contact: "Daniel Rosenberg" <drosen@goog 310 Contact: "Daniel Rosenberg" <drosen@google.com>
357 Description: Displays name and version of t 311 Description: Displays name and version of the encoding set for the filesystem.
358 If no encoding is set, display 312 If no encoding is set, displays (none)
359 313
360 What: /sys/fs/f2fs/<disk>/free_segme 314 What: /sys/fs/f2fs/<disk>/free_segments
361 Date: September 2019 315 Date: September 2019
362 Contact: "Hridya Valsaraju" <hridya@goog 316 Contact: "Hridya Valsaraju" <hridya@google.com>
363 Description: Number of free segments in dis 317 Description: Number of free segments in disk.
364 318
365 What: /sys/fs/f2fs/<disk>/cp_foregro 319 What: /sys/fs/f2fs/<disk>/cp_foreground_calls
366 Date: September 2019 320 Date: September 2019
367 Contact: "Hridya Valsaraju" <hridya@goog 321 Contact: "Hridya Valsaraju" <hridya@google.com>
368 Description: Number of checkpoint operation 322 Description: Number of checkpoint operations performed on demand. Available when
369 CONFIG_F2FS_STAT_FS=y. 323 CONFIG_F2FS_STAT_FS=y.
370 324
371 What: /sys/fs/f2fs/<disk>/cp_backgro 325 What: /sys/fs/f2fs/<disk>/cp_background_calls
372 Date: September 2019 326 Date: September 2019
373 Contact: "Hridya Valsaraju" <hridya@goog 327 Contact: "Hridya Valsaraju" <hridya@google.com>
374 Description: Number of checkpoint operation 328 Description: Number of checkpoint operations performed in the background to
375 free segments. Available when 329 free segments. Available when CONFIG_F2FS_STAT_FS=y.
376 330
377 What: /sys/fs/f2fs/<disk>/gc_foregro 331 What: /sys/fs/f2fs/<disk>/gc_foreground_calls
378 Date: September 2019 332 Date: September 2019
379 Contact: "Hridya Valsaraju" <hridya@goog 333 Contact: "Hridya Valsaraju" <hridya@google.com>
380 Description: Number of garbage collection o 334 Description: Number of garbage collection operations performed on demand.
381 Available when CONFIG_F2FS_STA 335 Available when CONFIG_F2FS_STAT_FS=y.
382 336
383 What: /sys/fs/f2fs/<disk>/gc_backgro 337 What: /sys/fs/f2fs/<disk>/gc_background_calls
384 Date: September 2019 338 Date: September 2019
385 Contact: "Hridya Valsaraju" <hridya@goog 339 Contact: "Hridya Valsaraju" <hridya@google.com>
386 Description: Number of garbage collection o 340 Description: Number of garbage collection operations triggered in background.
387 Available when CONFIG_F2FS_STA 341 Available when CONFIG_F2FS_STAT_FS=y.
388 342
389 What: /sys/fs/f2fs/<disk>/moved_bloc 343 What: /sys/fs/f2fs/<disk>/moved_blocks_foreground
390 Date: September 2019 344 Date: September 2019
391 Contact: "Hridya Valsaraju" <hridya@goog 345 Contact: "Hridya Valsaraju" <hridya@google.com>
392 Description: Number of blocks moved by garb 346 Description: Number of blocks moved by garbage collection in foreground.
393 Available when CONFIG_F2FS_STA 347 Available when CONFIG_F2FS_STAT_FS=y.
394 348
395 What: /sys/fs/f2fs/<disk>/moved_bloc 349 What: /sys/fs/f2fs/<disk>/moved_blocks_background
396 Date: September 2019 350 Date: September 2019
397 Contact: "Hridya Valsaraju" <hridya@goog 351 Contact: "Hridya Valsaraju" <hridya@google.com>
398 Description: Number of blocks moved by garb 352 Description: Number of blocks moved by garbage collection in background.
399 Available when CONFIG_F2FS_STA 353 Available when CONFIG_F2FS_STAT_FS=y.
400 354
401 What: /sys/fs/f2fs/<disk>/avg_vblock 355 What: /sys/fs/f2fs/<disk>/avg_vblocks
402 Date: September 2019 356 Date: September 2019
403 Contact: "Hridya Valsaraju" <hridya@goog 357 Contact: "Hridya Valsaraju" <hridya@google.com>
404 Description: Average number of valid blocks 358 Description: Average number of valid blocks.
405 Available when CONFIG_F2FS_STA 359 Available when CONFIG_F2FS_STAT_FS=y.
406 360
407 What: /sys/fs/f2fs/<disk>/mounted_ti 361 What: /sys/fs/f2fs/<disk>/mounted_time_sec
408 Date: February 2020 362 Date: February 2020
409 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o 363 Contact: "Jaegeuk Kim" <jaegeuk@kernel.org>
410 Description: Show the mounted time in secs 364 Description: Show the mounted time in secs of this partition.
411 365
412 What: /sys/fs/f2fs/<disk>/data_io_fl 366 What: /sys/fs/f2fs/<disk>/data_io_flag
413 Date: April 2020 367 Date: April 2020
414 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o 368 Contact: "Jaegeuk Kim" <jaegeuk@kernel.org>
415 Description: Give a way to attach REQ_META| 369 Description: Give a way to attach REQ_META|FUA to data writes
416 given temperature-based bits. 370 given temperature-based bits. Now the bits indicate:
417 371
418 +-------------------+--------- 372 +-------------------+-------------------+
419 | REQ_META | REQ 373 | REQ_META | REQ_FUA |
420 +------+------+-----+------+-- 374 +------+------+-----+------+------+-----+
421 | 5 | 4 | 3 | 2 | 375 | 5 | 4 | 3 | 2 | 1 | 0 |
422 +------+------+-----+------+-- 376 +------+------+-----+------+------+-----+
423 | Cold | Warm | Hot | Cold | W 377 | Cold | Warm | Hot | Cold | Warm | Hot |
424 +------+------+-----+------+-- 378 +------+------+-----+------+------+-----+
425 379
426 What: /sys/fs/f2fs/<disk>/node_io_fl 380 What: /sys/fs/f2fs/<disk>/node_io_flag
427 Date: June 2020 381 Date: June 2020
428 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o 382 Contact: "Jaegeuk Kim" <jaegeuk@kernel.org>
429 Description: Give a way to attach REQ_META| 383 Description: Give a way to attach REQ_META|FUA to node writes
430 given temperature-based bits. 384 given temperature-based bits. Now the bits indicate:
431 385
432 +-------------------+--------- 386 +-------------------+-------------------+
433 | REQ_META | REQ 387 | REQ_META | REQ_FUA |
434 +------+------+-----+------+-- 388 +------+------+-----+------+------+-----+
435 | 5 | 4 | 3 | 2 | 389 | 5 | 4 | 3 | 2 | 1 | 0 |
436 +------+------+-----+------+-- 390 +------+------+-----+------+------+-----+
437 | Cold | Warm | Hot | Cold | W 391 | Cold | Warm | Hot | Cold | Warm | Hot |
438 +------+------+-----+------+-- 392 +------+------+-----+------+------+-----+
439 393
440 What: /sys/fs/f2fs/<disk>/iostat_per 394 What: /sys/fs/f2fs/<disk>/iostat_period_ms
441 Date: April 2020 395 Date: April 2020
442 Contact: "Daeho Jeong" <daehojeong@googl 396 Contact: "Daeho Jeong" <daehojeong@google.com>
443 Description: Give a way to change iostat_pe 397 Description: Give a way to change iostat_period time. 3secs by default.
444 The new iostat trace gives sta 398 The new iostat trace gives stats gap given the period.
445 What: /sys/fs/f2fs/<disk>/max_io_byt 399 What: /sys/fs/f2fs/<disk>/max_io_bytes
446 Date: December 2020 400 Date: December 2020
447 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o 401 Contact: "Jaegeuk Kim" <jaegeuk@kernel.org>
448 Description: This gives a control to limit 402 Description: This gives a control to limit the bio size in f2fs.
449 Default is zero, which will fo 403 Default is zero, which will follow underlying block layer limit,
450 whereas, if it has a certain b 404 whereas, if it has a certain bytes value, f2fs won't submit a
451 bio larger than that size. 405 bio larger than that size.
452 406
453 What: /sys/fs/f2fs/<disk>/stat/sb_st 407 What: /sys/fs/f2fs/<disk>/stat/sb_status
454 Date: December 2020 408 Date: December 2020
455 Contact: "Chao Yu" <yuchao0@huawei.com> 409 Contact: "Chao Yu" <yuchao0@huawei.com>
456 Description: Show status of f2fs superblock 410 Description: Show status of f2fs superblock in real time.
457 411
458 ====== ===================== = 412 ====== ===================== =================================
459 value sb status macro d 413 value sb status macro description
460 0x1 SBI_IS_DIRTY d 414 0x1 SBI_IS_DIRTY dirty flag for checkpoint
461 0x2 SBI_IS_CLOSE s 415 0x2 SBI_IS_CLOSE specify unmounting
462 0x4 SBI_NEED_FSCK n 416 0x4 SBI_NEED_FSCK need fsck.f2fs to fix
463 0x8 SBI_POR_DOING r 417 0x8 SBI_POR_DOING recovery is doing or not
464 0x10 SBI_NEED_SB_WRITE n 418 0x10 SBI_NEED_SB_WRITE need to recover superblock
465 0x20 SBI_NEED_CP n 419 0x20 SBI_NEED_CP need to checkpoint
466 0x40 SBI_IS_SHUTDOWN s 420 0x40 SBI_IS_SHUTDOWN shutdown by ioctl
467 0x80 SBI_IS_RECOVERED r 421 0x80 SBI_IS_RECOVERED recovered orphan/data
468 0x100 SBI_CP_DISABLED C 422 0x100 SBI_CP_DISABLED CP was disabled last mount
469 0x200 SBI_CP_DISABLED_QUICK C 423 0x200 SBI_CP_DISABLED_QUICK CP was disabled quickly
470 0x400 SBI_QUOTA_NEED_FLUSH n 424 0x400 SBI_QUOTA_NEED_FLUSH need to flush quota info in CP
471 0x800 SBI_QUOTA_SKIP_FLUSH s 425 0x800 SBI_QUOTA_SKIP_FLUSH skip flushing quota in current CP
472 0x1000 SBI_QUOTA_NEED_REPAIR q 426 0x1000 SBI_QUOTA_NEED_REPAIR quota file may be corrupted
473 0x2000 SBI_IS_RESIZEFS r 427 0x2000 SBI_IS_RESIZEFS resizefs is in process
474 0x4000 SBI_IS_FREEZING f 428 0x4000 SBI_IS_FREEZING freefs is in process
475 ====== ===================== = 429 ====== ===================== =================================
476 430
477 What: /sys/fs/f2fs/<disk>/stat/cp_st <<
478 Date: September 2022 <<
479 Contact: "Chao Yu" <chao.yu@oppo.com> <<
480 Description: Show status of f2fs checkpoint <<
481 <<
482 ============================== <<
483 cp flag <<
484 CP_UMOUNT_FLAG <<
485 CP_ORPHAN_PRESENT_FLAG <<
486 CP_COMPACT_SUM_FLAG <<
487 CP_ERROR_FLAG <<
488 CP_FSCK_FLAG <<
489 CP_FASTBOOT_FLAG <<
490 CP_CRC_RECOVERY_FLAG <<
491 CP_NAT_BITS_FLAG <<
492 CP_TRIMMED_FLAG <<
493 CP_NOCRC_RECOVERY_FLAG <<
494 CP_LARGE_NAT_BITMAP_FLAG <<
495 CP_QUOTA_NEED_FSCK_FLAG <<
496 CP_DISABLED_FLAG <<
497 CP_DISABLED_QUICK_FLAG <<
498 CP_RESIZEFS_FLAG <<
499 ============================== <<
500 <<
501 What: /sys/fs/f2fs/<disk>/stat/issue <<
502 Date: December 2023 <<
503 Contact: "Zhiguo Niu" <zhiguo.niu@unisoc <<
504 Description: Shows the number of issued dis <<
505 <<
506 What: /sys/fs/f2fs/<disk>/stat/queue <<
507 Date: December 2023 <<
508 Contact: "Zhiguo Niu" <zhiguo.niu@unisoc <<
509 Description: Shows the number of queued dis <<
510 <<
511 What: /sys/fs/f2fs/<disk>/stat/undis <<
512 Date: December 2023 <<
513 Contact: "Zhiguo Niu" <zhiguo.niu@unisoc <<
514 Description: Shows the total number of undi <<
515 <<
516 What: /sys/fs/f2fs/<disk>/ckpt_threa 431 What: /sys/fs/f2fs/<disk>/ckpt_thread_ioprio
517 Date: January 2021 432 Date: January 2021
518 Contact: "Daeho Jeong" <daehojeong@googl 433 Contact: "Daeho Jeong" <daehojeong@google.com>
519 Description: Give a way to change checkpoin 434 Description: Give a way to change checkpoint merge daemon's io priority.
520 Its default value is "be,3", w 435 Its default value is "be,3", which means "BE" I/O class and
521 I/O priority "3". We can selec 436 I/O priority "3". We can select the class between "rt" and "be",
522 and set the I/O priority withi 437 and set the I/O priority within valid range of it. "," delimiter
523 is necessary in between I/O cl 438 is necessary in between I/O class and priority number.
524 439
525 What: /sys/fs/f2fs/<disk>/ovp_segmen 440 What: /sys/fs/f2fs/<disk>/ovp_segments
526 Date: March 2021 441 Date: March 2021
527 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o 442 Contact: "Jaegeuk Kim" <jaegeuk@kernel.org>
528 Description: Shows the number of overprovis 443 Description: Shows the number of overprovision segments.
529 444
530 What: /sys/fs/f2fs/<disk>/compr_writ 445 What: /sys/fs/f2fs/<disk>/compr_written_block
531 Date: March 2021 446 Date: March 2021
532 Contact: "Daeho Jeong" <daehojeong@googl 447 Contact: "Daeho Jeong" <daehojeong@google.com>
533 Description: Show the block count written a 448 Description: Show the block count written after compression since mount. Note
534 that when the compressed block 449 that when the compressed blocks are deleted, this count doesn't
535 decrease. If you write "0" her 450 decrease. If you write "0" here, you can initialize
536 compr_written_block and compr_ 451 compr_written_block and compr_saved_block to "0".
537 452
538 What: /sys/fs/f2fs/<disk>/compr_save 453 What: /sys/fs/f2fs/<disk>/compr_saved_block
539 Date: March 2021 454 Date: March 2021
540 Contact: "Daeho Jeong" <daehojeong@googl 455 Contact: "Daeho Jeong" <daehojeong@google.com>
541 Description: Show the saved block count wit 456 Description: Show the saved block count with compression since mount. Note
542 that when the compressed block 457 that when the compressed blocks are deleted, this count doesn't
543 decrease. If you write "0" her 458 decrease. If you write "0" here, you can initialize
544 compr_written_block and compr_ 459 compr_written_block and compr_saved_block to "0".
545 460
546 What: /sys/fs/f2fs/<disk>/compr_new_ 461 What: /sys/fs/f2fs/<disk>/compr_new_inode
547 Date: March 2021 462 Date: March 2021
548 Contact: "Daeho Jeong" <daehojeong@googl 463 Contact: "Daeho Jeong" <daehojeong@google.com>
549 Description: Show the count of inode newly 464 Description: Show the count of inode newly enabled for compression since mount.
550 Note that when the compression 465 Note that when the compression is disabled for the files, this count
551 doesn't decrease. If you write 466 doesn't decrease. If you write "0" here, you can initialize
552 compr_new_inode to "0". 467 compr_new_inode to "0".
553 468
554 What: /sys/fs/f2fs/<disk>/atgc_candi 469 What: /sys/fs/f2fs/<disk>/atgc_candidate_ratio
555 Date: May 2021 470 Date: May 2021
556 Contact: "Chao Yu" <yuchao0@huawei.com> 471 Contact: "Chao Yu" <yuchao0@huawei.com>
557 Description: When ATGC is on, it controls c 472 Description: When ATGC is on, it controls candidate ratio in order to limit total
558 number of potential victim in 473 number of potential victim in all candidates, the value should be in
559 range of [0, 100], by default 474 range of [0, 100], by default it was initialized as 20(%).
560 475
561 What: /sys/fs/f2fs/<disk>/atgc_candi 476 What: /sys/fs/f2fs/<disk>/atgc_candidate_count
562 Date: May 2021 477 Date: May 2021
563 Contact: "Chao Yu" <yuchao0@huawei.com> 478 Contact: "Chao Yu" <yuchao0@huawei.com>
564 Description: When ATGC is on, it controls c 479 Description: When ATGC is on, it controls candidate count in order to limit total
565 number of potential victim in 480 number of potential victim in all candidates, by default it was
566 initialized as 10 (sections). 481 initialized as 10 (sections).
567 482
568 What: /sys/fs/f2fs/<disk>/atgc_age_w 483 What: /sys/fs/f2fs/<disk>/atgc_age_weight
569 Date: May 2021 484 Date: May 2021
570 Contact: "Chao Yu" <yuchao0@huawei.com> 485 Contact: "Chao Yu" <yuchao0@huawei.com>
571 Description: When ATGC is on, it controls a 486 Description: When ATGC is on, it controls age weight to balance weight proportion
572 in between aging and valid blo 487 in between aging and valid blocks, the value should be in range of
573 [0, 100], by default it was in 488 [0, 100], by default it was initialized as 60(%).
574 489
575 What: /sys/fs/f2fs/<disk>/atgc_age_t 490 What: /sys/fs/f2fs/<disk>/atgc_age_threshold
576 Date: May 2021 491 Date: May 2021
577 Contact: "Chao Yu" <yuchao0@huawei.com> 492 Contact: "Chao Yu" <yuchao0@huawei.com>
578 Description: When ATGC is on, it controls a 493 Description: When ATGC is on, it controls age threshold to bypass GCing young
579 candidates whose age is not be 494 candidates whose age is not beyond the threshold, by default it was
580 initialized as 604800 seconds 495 initialized as 604800 seconds (equals to 7 days).
581 496
582 What: /sys/fs/f2fs/<disk>/atgc_enabl <<
583 Date: Feb 2024 <<
584 Contact: "Jinbao Liu" <liujinbao1@xiaomi <<
585 Description: It represents whether ATGC is <<
586 indicates that ATGC is on, and <<
587 <<
588 What: /sys/fs/f2fs/<disk>/gc_reclaim 497 What: /sys/fs/f2fs/<disk>/gc_reclaimed_segments
589 Date: July 2021 498 Date: July 2021
590 Contact: "Daeho Jeong" <daehojeong@googl 499 Contact: "Daeho Jeong" <daehojeong@google.com>
591 Description: Show how many segments have be 500 Description: Show how many segments have been reclaimed by GC during a specific
592 GC mode (0: GC normal, 1: GC i 501 GC mode (0: GC normal, 1: GC idle CB, 2: GC idle greedy,
593 3: GC idle AT, 4: GC urgent hi !! 502 3: GC idle AT, 4: GC urgent high, 5: GC urgent low)
594 You can re-initialize this val 503 You can re-initialize this value to "0".
595 504
596 What: /sys/fs/f2fs/<disk>/gc_segment 505 What: /sys/fs/f2fs/<disk>/gc_segment_mode
597 Date: July 2021 506 Date: July 2021
598 Contact: "Daeho Jeong" <daehojeong@googl 507 Contact: "Daeho Jeong" <daehojeong@google.com>
599 Description: You can control for which gc m 508 Description: You can control for which gc mode the "gc_reclaimed_segments" node shows.
600 Refer to the description of th 509 Refer to the description of the modes in "gc_reclaimed_segments".
601 510
602 What: /sys/fs/f2fs/<disk>/seq_file_r 511 What: /sys/fs/f2fs/<disk>/seq_file_ra_mul
603 Date: July 2021 512 Date: July 2021
604 Contact: "Daeho Jeong" <daehojeong@googl 513 Contact: "Daeho Jeong" <daehojeong@google.com>
605 Description: You can control the multiplier 514 Description: You can control the multiplier value of bdi device readahead window size
606 between 2 (default) and 256 fo 515 between 2 (default) and 256 for POSIX_FADV_SEQUENTIAL advise option.
607 516
608 What: /sys/fs/f2fs/<disk>/max_fragme 517 What: /sys/fs/f2fs/<disk>/max_fragment_chunk
609 Date: August 2021 518 Date: August 2021
610 Contact: "Daeho Jeong" <daehojeong@googl 519 Contact: "Daeho Jeong" <daehojeong@google.com>
611 Description: With "mode=fragment:block" mou 520 Description: With "mode=fragment:block" mount options, we can scatter block allocation.
612 f2fs will allocate 1..<max_fra 521 f2fs will allocate 1..<max_fragment_chunk> blocks in a chunk and make a hole
613 in the length of 1..<max_fragm 522 in the length of 1..<max_fragment_hole> by turns. This value can be set
614 between 1..512 and the default 523 between 1..512 and the default value is 4.
615 524
616 What: /sys/fs/f2fs/<disk>/max_fragme 525 What: /sys/fs/f2fs/<disk>/max_fragment_hole
617 Date: August 2021 526 Date: August 2021
618 Contact: "Daeho Jeong" <daehojeong@googl 527 Contact: "Daeho Jeong" <daehojeong@google.com>
619 Description: With "mode=fragment:block" mou 528 Description: With "mode=fragment:block" mount options, we can scatter block allocation.
620 f2fs will allocate 1..<max_fra 529 f2fs will allocate 1..<max_fragment_chunk> blocks in a chunk and make a hole
621 in the length of 1..<max_fragm 530 in the length of 1..<max_fragment_hole> by turns. This value can be set
622 between 1..512 and the default 531 between 1..512 and the default value is 4.
623 <<
624 What: /sys/fs/f2fs/<disk>/gc_remaini <<
625 Date: October 2022 <<
626 Contact: "Yangtao Li" <frank.li@vivo.com <<
627 Description: You can set the trial count li <<
628 If GC thread gets to the limit <<
629 By default, the value is zero, <<
630 <<
631 What: /sys/fs/f2fs/<disk>/max_roll_f <<
632 Date: January 2022 <<
633 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o <<
634 Description: Controls max # of node block w <<
635 recovery. This can limit the r <<
636 <<
637 What: /sys/fs/f2fs/<disk>/unusable_b <<
638 Date: June 2022 <<
639 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o <<
640 Description: Shows the number of unusable b <<
641 the zone capacity reported by <<
642 <<
643 What: /sys/fs/f2fs/<disk>/current_at <<
644 Date: July 2022 <<
645 Contact: "Daeho Jeong" <daehojeong@googl <<
646 Description: Show the total current atomic <<
647 This is a read-only entry. <<
648 <<
649 What: /sys/fs/f2fs/<disk>/peak_atomi <<
650 Date: July 2022 <<
651 Contact: "Daeho Jeong" <daehojeong@googl <<
652 Description: Show the peak value of total c <<
653 If you write "0" here, you can <<
654 <<
655 What: /sys/fs/f2fs/<disk>/committed_ <<
656 Date: July 2022 <<
657 Contact: "Daeho Jeong" <daehojeong@googl <<
658 Description: Show the accumulated total com <<
659 If you write "0" here, you can <<
660 <<
661 What: /sys/fs/f2fs/<disk>/revoked_at <<
662 Date: July 2022 <<
663 Contact: "Daeho Jeong" <daehojeong@googl <<
664 Description: Show the accumulated total rev <<
665 If you write "0" here, you can <<
666 <<
667 What: /sys/fs/f2fs/<disk>/gc_mode <<
668 Date: October 2022 <<
669 Contact: "Yangtao Li" <frank.li@vivo.com <<
670 Description: Show the current gc_mode as a <<
671 This is a read-only entry. <<
672 <<
673 What: /sys/fs/f2fs/<disk>/discard_ur <<
674 Date: November 2022 <<
675 Contact: "Yangtao Li" <frank.li@vivo.com <<
676 Description: When space utilization exceeds <<
677 Does DISCARD forcibly in a per <<
678 of discards is not 0 and set d <<
679 Default: 80 <<
680 <<
681 What: /sys/fs/f2fs/<disk>/hot_data_a <<
682 Date: November 2022 <<
683 Contact: "Ping Xiong" <xiongping1@xiaomi <<
684 Description: When DATA SEPARATION is on, it <<
685 the data blocks as hot. By def <<
686 (equals to 1GB). <<
687 <<
688 What: /sys/fs/f2fs/<disk>/warm_data_ <<
689 Date: November 2022 <<
690 Contact: "Ping Xiong" <xiongping1@xiaomi <<
691 Description: When DATA SEPARATION is on, it <<
692 the data blocks as warm. By de <<
693 (equals to 10GB). <<
694 <<
695 What: /sys/fs/f2fs/<disk>/fault_rate <<
696 Date: May 2016 <<
697 Contact: "Sheng Yong" <shengyong@oppo.co <<
698 Contact: "Chao Yu" <chao@kernel.org> <<
699 Description: Enable fault injection in all <<
700 specified injection rate. <<
701 <<
702 What: /sys/fs/f2fs/<disk>/fault_type <<
703 Date: May 2016 <<
704 Contact: "Sheng Yong" <shengyong@oppo.co <<
705 Contact: "Chao Yu" <chao@kernel.org> <<
706 Description: Support configuring fault inje <<
707 enabled with fault_injection o <<
708 is shown below, it supports si <<
709 <<
710 =========================== <<
711 Type_Name <<
712 =========================== <<
713 FAULT_KMALLOC <<
714 FAULT_KVMALLOC <<
715 FAULT_PAGE_ALLOC <<
716 FAULT_PAGE_GET <<
717 FAULT_ALLOC_BIO <<
718 FAULT_ALLOC_NID <<
719 FAULT_ORPHAN <<
720 FAULT_BLOCK <<
721 FAULT_DIR_DEPTH <<
722 FAULT_EVICT_INODE <<
723 FAULT_TRUNCATE <<
724 FAULT_READ_IO <<
725 FAULT_CHECKPOINT <<
726 FAULT_DISCARD <<
727 FAULT_WRITE_IO <<
728 FAULT_SLAB_ALLOC <<
729 FAULT_DQUOT_INIT <<
730 FAULT_LOCK_OP <<
731 FAULT_BLKADDR_VALIDITY <<
732 FAULT_BLKADDR_CONSISTENCE <<
733 FAULT_NO_SEGMENT <<
734 =========================== <<
735 <<
736 What: /sys/fs/f2fs/<disk>/discard_io <<
737 Date: January 2023 <<
738 Contact: "Yangtao Li" <frank.li@vivo.com <<
739 Description: Controls background discard gr <<
740 when is not in idle. Inner thr <<
741 is smaller than granularity. T <<
742 support configuring in range o <<
743 Default: 512 <<
744 <<
745 What: /sys/fs/f2fs/<disk>/last_age_w <<
746 Date: January 2023 <<
747 Contact: "Ping Xiong" <xiongping1@xiaomi <<
748 Description: When DATA SEPARATION is on, it <<
749 <<
750 What: /sys/fs/f2fs/<disk>/compress_w <<
751 Date: February 2023 <<
752 Contact: "Yangtao Li" <frank.li@vivo.com <<
753 Description: When compress cache is on, it <<
754 in order to limit caching comp <<
755 than watermark, then deny cach <<
756 range of (0, 100], by default <<
757 <<
758 What: /sys/fs/f2fs/<disk>/compress_p <<
759 Date: February 2023 <<
760 Contact: "Yangtao Li" <frank.li@vivo.com <<
761 Description: When compress cache is on, it <<
762 percent(compress pages / free_ <<
763 If cached page percent exceed <<
764 The value should be in range o <<
765 as 20(%). <<
766 <<
767 What: /sys/fs/f2fs/<disk>/discard_io <<
768 Date: November 2023 <<
769 Contact: "Chao Yu" <chao@kernel.org> <<
770 Description: It controls to enable/disable <<
771 By default, the value is 1 whi <<
772 <<
773 What: /sys/fs/f2fs/<disk>/blkzone_al <<
774 Date: July 2024 <<
775 Contact: "Yuanhong Liao" <liaoyuanhong@v <<
776 Description: The zone UFS we are currently <<
777 conventional zones and sequent <<
778 to prioritize for writes, with <<
779 <<
780 ======================== ==== <<
781 value <<
782 blkzone_alloc_policy = 0 Prio <<
783 blkzone_alloc_policy = 1 Only <<
784 blkzone_alloc_policy = 2 Prio <<
785 ======================== ==== <<
786 <<
787 What: /sys/fs/f2fs/<disk>/migration_ <<
788 Date: September 2024 <<
789 Contact: "Daeho Jeong" <daehojeong@googl <<
790 Description: Controls migration window gran <<
791 section. it can control the sc <<
792 in a unit of segment, while mi <<
793 of segments which can be migra <<
794 <<
795 What: /sys/fs/f2fs/<disk>/reserved_s <<
796 Date: September 2024 <<
797 Contact: "Daeho Jeong" <daehojeong@googl <<
798 Description: In order to fine tune GC behav <<
799 reserved segments. <<
800 <<
801 What: /sys/fs/f2fs/<disk>/gc_no_zone <<
802 Date: September 2024 <<
803 Contact: "Daeho Jeong" <daehojeong@googl <<
804 Description: If the percentage of free sect <<
805 number, F2FS do not garbage co <<
806 background GC thread. the defa <<
807 <<
808 What: /sys/fs/f2fs/<disk>/gc_boost_z <<
809 Date: September 2024 <<
810 Contact: "Daeho Jeong" <daehojeong@googl <<
811 Description: If the percentage of free sect <<
812 number, F2FS boosts garbage co <<
813 background GC thread. the defa <<
814 <<
815 What: /sys/fs/f2fs/<disk>/gc_valid_t <<
816 Date: September 2024 <<
817 Contact: "Daeho Jeong" <daehojeong@googl <<
818 Description: It controls the valid block ra <<
819 for zoned deivces. The initial <<
820 background GC thread from inti <<
821 exceeding the ratio. <<
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.