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:
5 is in milliseconds. !! 5 Controls the maximun sleep time for gc_thread. Time
>> 6 is in milliseconds.
6 7
7 What: /sys/fs/f2fs/<disk>/gc_min_sle 8 What: /sys/fs/f2fs/<disk>/gc_min_sleep_time
8 Date: July 2013 9 Date: July 2013
9 Contact: "Namjae Jeon" <namjae.jeon@sams 10 Contact: "Namjae Jeon" <namjae.jeon@samsung.com>
10 Description: Controls the minimum sleep tim !! 11 Description:
11 is in milliseconds. !! 12 Controls the minimum sleep time for gc_thread. Time
>> 13 is in milliseconds.
12 14
13 What: /sys/fs/f2fs/<disk>/gc_no_gc_s 15 What: /sys/fs/f2fs/<disk>/gc_no_gc_sleep_time
14 Date: July 2013 16 Date: July 2013
15 Contact: "Namjae Jeon" <namjae.jeon@sams 17 Contact: "Namjae Jeon" <namjae.jeon@samsung.com>
16 Description: Controls the default sleep tim !! 18 Description:
17 is in milliseconds. !! 19 Controls the default sleep time for gc_thread. Time
>> 20 is in milliseconds.
18 21
19 What: /sys/fs/f2fs/<disk>/gc_idle 22 What: /sys/fs/f2fs/<disk>/gc_idle
20 Date: July 2013 23 Date: July 2013
21 Contact: "Namjae Jeon" <namjae.jeon@sams 24 Contact: "Namjae Jeon" <namjae.jeon@samsung.com>
22 Description: Controls the victim selection !! 25 Description:
23 Setting gc_idle = 0(default) w !! 26 Controls the victim selection policy for garbage collection.
24 <<
25 =========== ================= <<
26 gc_idle = 1 will select the C <<
27 gc_idle = 2 will select the g <<
28 gc_idle = 3 will select the a <<
29 =========== ================= <<
30 27
31 What: /sys/fs/f2fs/<disk>/reclaim_se 28 What: /sys/fs/f2fs/<disk>/reclaim_segments
32 Date: October 2013 29 Date: October 2013
33 Contact: "Jaegeuk Kim" <jaegeuk.kim@sams 30 Contact: "Jaegeuk Kim" <jaegeuk.kim@samsung.com>
34 Description: This parameter controls the nu !! 31 Description:
35 reclaimed. If the number of pr !! 32 Controls the issue rate of segment discard commands.
36 the number of segments in the <<
37 over total volume size, f2fs t <<
38 reclaim the prefree segments t <<
39 By default, 5% over total # of <<
40 <<
41 What: /sys/fs/f2fs/<disk>/main_blkad <<
42 Date: November 2019 <<
43 Contact: "Ramon Pantin" <pantin@google.c <<
44 Description: Shows first block address of M <<
45 33
46 What: /sys/fs/f2fs/<disk>/ipu_policy 34 What: /sys/fs/f2fs/<disk>/ipu_policy
47 Date: November 2013 35 Date: November 2013
48 Contact: "Jaegeuk Kim" <jaegeuk.kim@sams 36 Contact: "Jaegeuk Kim" <jaegeuk.kim@samsung.com>
49 Description: Controls the in-place-update p !! 37 Description:
50 updates in f2fs. User can set: !! 38 Controls the in-place-update policy.
51 <<
52 ===== =============== ======== <<
53 value policy descript <<
54 0x00 DISABLE disable <<
55 0x01 FORCE all the <<
56 0x02 SSR if SSR m <<
57 0x04 UTIL if FS ut <<
58 0x08 SSR_UTIL if SSR m <<
59 threshol <<
60 0x10 FSYNC activate <<
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 <<
70 Refer segment.h for details. <<
71 39
72 What: /sys/fs/f2fs/<disk>/min_ipu_ut 40 What: /sys/fs/f2fs/<disk>/min_ipu_util
73 Date: November 2013 41 Date: November 2013
74 Contact: "Jaegeuk Kim" <jaegeuk.kim@sams 42 Contact: "Jaegeuk Kim" <jaegeuk.kim@samsung.com>
75 Description: Controls the FS utilization co !! 43 Description:
76 policies. It is used by F2FS_I !! 44 Controls the FS utilization condition for the in-place-update
>> 45 policies.
77 46
78 What: /sys/fs/f2fs/<disk>/min_fsync_ 47 What: /sys/fs/f2fs/<disk>/min_fsync_blocks
79 Date: September 2014 48 Date: September 2014
80 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o 49 Contact: "Jaegeuk Kim" <jaegeuk@kernel.org>
81 Description: Controls the dirty page count !! 50 Description:
82 policies. !! 51 Controls the dirty page count condition for the in-place-update
83 !! 52 policies.
84 What: /sys/fs/f2fs/<disk>/min_seq_bl <<
85 Date: August 2018 <<
86 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o <<
87 Description: Controls the dirty page count <<
88 writes in writepages. <<
89 <<
90 What: /sys/fs/f2fs/<disk>/min_hot_bl <<
91 Date: March 2017 <<
92 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o <<
93 Description: Controls the dirty page count <<
94 <<
95 What: /sys/fs/f2fs/<disk>/min_ssr_se <<
96 Date: October 2017 <<
97 Contact: "Chao Yu" <yuchao0@huawei.com> <<
98 Description: Controls the free section thre <<
99 If this is large, SSR mode wil <<
100 53
101 What: /sys/fs/f2fs/<disk>/max_small_ 54 What: /sys/fs/f2fs/<disk>/max_small_discards
102 Date: November 2013 55 Date: November 2013
103 Contact: "Jaegeuk Kim" <jaegeuk.kim@sams 56 Contact: "Jaegeuk Kim" <jaegeuk.kim@samsung.com>
104 Description: Controls the issue rate of dis !! 57 Description:
105 blocks less than 2MB. The cand !! 58 Controls the issue rate of small discard commands.
106 checkpoint, and issued by issu <<
107 It is enabled by default. <<
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 <<
142 What: /sys/fs/f2fs/<disk>/discard_gr <<
143 Date: July 2017 <<
144 Contact: "Chao Yu" <yuchao0@huawei.com> <<
145 Description: Controls discard granularity o <<
146 will not issue discards with s <<
147 The unit size is one block(4KB <<
148 in range of [1, 512]. Default <<
149 For small devices, default val <<
150 <<
151 What: /sys/fs/f2fs/<disk>/umount_dis <<
152 Date: January 2019 <<
153 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o <<
154 Description: Set timeout to issue discard c <<
155 Default: 5 secs <<
156 <<
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 59
162 What: /sys/fs/f2fs/<disk>/max_victim 60 What: /sys/fs/f2fs/<disk>/max_victim_search
163 Date: January 2014 61 Date: January 2014
164 Contact: "Jaegeuk Kim" <jaegeuk.kim@sams 62 Contact: "Jaegeuk Kim" <jaegeuk.kim@samsung.com>
165 Description: Controls the number of trials !! 63 Description:
166 when conducting SSR and cleani !! 64 Controls the number of trials to find a victim segment.
167 is 4096 which covers 8GB block <<
168 <<
169 What: /sys/fs/f2fs/<disk>/migration_ <<
170 Date: October 2018 <<
171 Contact: "Chao Yu" <yuchao0@huawei.com> <<
172 Description: Controls migration granularity <<
173 section, it can let GC move pa <<
174 in one GC cycle, so that dispe <<
175 multiple lightweight one. <<
176 65
177 What: /sys/fs/f2fs/<disk>/dir_level 66 What: /sys/fs/f2fs/<disk>/dir_level
178 Date: March 2014 67 Date: March 2014
179 Contact: "Jaegeuk Kim" <jaegeuk.kim@sams 68 Contact: "Jaegeuk Kim" <jaegeuk.kim@samsung.com>
180 Description: Controls the directory level f !! 69 Description:
181 directory has a number of file !! 70 Controls the directory level for large directory.
182 latency by increasing this dir <<
183 needs to decrease this value t <<
184 The default value is 0. <<
185 71
186 What: /sys/fs/f2fs/<disk>/ram_thresh 72 What: /sys/fs/f2fs/<disk>/ram_thresh
187 Date: March 2014 73 Date: March 2014
188 Contact: "Jaegeuk Kim" <jaegeuk.kim@sams 74 Contact: "Jaegeuk Kim" <jaegeuk.kim@samsung.com>
189 Description: Controls the memory footprint !! 75 Description:
190 nat entries. By default, 1 is !! 76 Controls the memory footprint used by f2fs.
191 10 MB / 1 GB RAM. !! 77
>> 78 What: /sys/fs/f2fs/<disk>/batched_trim_sections
>> 79 Date: February 2015
>> 80 Contact: "Jaegeuk Kim" <jaegeuk@kernel.org>
>> 81 Description:
>> 82 Controls the trimming rate in batch mode.
192 83
193 What: /sys/fs/f2fs/<disk>/cp_interva 84 What: /sys/fs/f2fs/<disk>/cp_interval
194 Date: October 2015 85 Date: October 2015
195 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o 86 Contact: "Jaegeuk Kim" <jaegeuk@kernel.org>
196 Description: Controls the checkpoint timing !! 87 Description:
>> 88 Controls the checkpoint timing.
197 89
198 What: /sys/fs/f2fs/<disk>/idle_inter 90 What: /sys/fs/f2fs/<disk>/idle_interval
199 Date: January 2016 91 Date: January 2016
200 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o 92 Contact: "Jaegeuk Kim" <jaegeuk@kernel.org>
201 Description: Controls the idle timing of sy !! 93 Description:
202 during given interval. !! 94 Controls the idle timing.
203 Set to 5 seconds by default. <<
204 <<
205 What: /sys/fs/f2fs/<disk>/discard_id <<
206 Date: September 2018 <<
207 Contact: "Chao Yu" <yuchao0@huawei.com> <<
208 Contact: "Sahitya Tummala" <quic_stummal <<
209 Description: Controls the idle timing of di <<
210 this time interval. <<
211 Default is 5 secs. <<
212 <<
213 What: /sys/fs/f2fs/<disk>/gc_idle_in <<
214 Date: September 2018 <<
215 Contact: "Chao Yu" <yuchao0@huawei.com> <<
216 Contact: "Sahitya Tummala" <quic_stummal <<
217 Description: Controls the idle timing for g <<
218 <<
219 What: /sys/fs/f2fs/<disk>/iostat_ena <<
220 Date: August 2017 <<
221 Contact: "Chao Yu" <yuchao0@huawei.com> <<
222 Description: Controls to enable/disable IO <<
223 95
224 What: /sys/fs/f2fs/<disk>/ra_nid_pag 96 What: /sys/fs/f2fs/<disk>/ra_nid_pages
225 Date: October 2015 97 Date: October 2015
226 Contact: "Chao Yu" <chao2.yu@samsung.com 98 Contact: "Chao Yu" <chao2.yu@samsung.com>
227 Description: Controls the count of nid page !! 99 Description:
228 When building free nids, F2FS !! 100 Controls the count of nid pages to be readaheaded.
229 speed up. Default is 0. <<
230 101
231 What: /sys/fs/f2fs/<disk>/dirty_nats 102 What: /sys/fs/f2fs/<disk>/dirty_nats_ratio
232 Date: January 2016 103 Date: January 2016
233 Contact: "Chao Yu" <chao2.yu@samsung.com 104 Contact: "Chao Yu" <chao2.yu@samsung.com>
234 Description: Controls dirty nat entries rat !! 105 Description:
235 ratio exceeds configured thres !! 106 Controls dirty nat entries ratio threshold, if current
236 be triggered for flushing dirt !! 107 ratio exceeds configured threshold, checkpoint will
>> 108 be triggered for flushing dirty nat entries.
237 109
238 What: /sys/fs/f2fs/<disk>/lifetime_w 110 What: /sys/fs/f2fs/<disk>/lifetime_write_kbytes
239 Date: January 2016 111 Date: January 2016
240 Contact: "Shuoran Liu" <liushuoran@huawe 112 Contact: "Shuoran Liu" <liushuoran@huawei.com>
241 Description: Shows total written kbytes iss !! 113 Description:
242 !! 114 Shows total written kbytes issued to disk.
243 What: /sys/fs/f2fs/<disk>/features <<
244 Date: July 2017 <<
245 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o <<
246 Description: <deprecated: should use /sys/f <<
247 Shows all enabled features in <<
248 Supported features: <<
249 encryption, blkzoned, extra_at <<
250 flexible_inline_xattr, quota_i <<
251 verity, sb_checksum, casefold, <<
252 <<
253 What: /sys/fs/f2fs/<disk>/feature_li <<
254 Date: June 2021 <<
255 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o <<
256 Description: Expand /sys/fs/f2fs/<disk>/fea <<
257 Supported on-disk features: <<
258 encryption, block_zoned (aka b <<
259 project_quota (aka projquota), <<
260 flexible_inline_xattr, quota_i <<
261 verity, sb_checksum, casefold, <<
262 Note that, pin_file is moved i <<
263 <<
264 What: /sys/fs/f2fs/features/ <<
265 Date: July 2017 <<
266 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o <<
267 Description: Shows all enabled kernel featu <<
268 Supported features: <<
269 encryption, block_zoned, extra <<
270 inode_checksum, flexible_inlin <<
271 inode_crtime, lost_found, veri <<
272 casefold, readonly, compressio <<
273 atomic_write, pin_file, encryp <<
274 115
275 What: /sys/fs/f2fs/<disk>/inject_rat 116 What: /sys/fs/f2fs/<disk>/inject_rate
276 Date: May 2016 117 Date: May 2016
277 Contact: "Sheng Yong" <shengyong1@huawei 118 Contact: "Sheng Yong" <shengyong1@huawei.com>
278 Description: Controls the injection rate of !! 119 Description:
>> 120 Controls the injection rate.
279 121
280 What: /sys/fs/f2fs/<disk>/inject_typ 122 What: /sys/fs/f2fs/<disk>/inject_type
281 Date: May 2016 123 Date: May 2016
282 Contact: "Sheng Yong" <shengyong1@huawei 124 Contact: "Sheng Yong" <shengyong1@huawei.com>
283 Description: Controls the injection type of !! 125 Description:
284 !! 126 Controls the injection type.
285 What: /sys/fs/f2fs/<disk>/dirty_segm <<
286 Date: October 2017 <<
287 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o <<
288 Description: Shows the number of dirty segm <<
289 127
290 What: /sys/fs/f2fs/<disk>/reserved_b 128 What: /sys/fs/f2fs/<disk>/reserved_blocks
291 Date: June 2017 129 Date: June 2017
292 Contact: "Chao Yu" <yuchao0@huawei.com> 130 Contact: "Chao Yu" <yuchao0@huawei.com>
293 Description: Controls target reserved block !! 131 Description:
294 is soft, it could exceed curre !! 132 Controls current reserved blocks in system.
295 <<
296 What: /sys/fs/f2fs/<disk>/current_re <<
297 Date: October 2017 <<
298 Contact: "Yunlong Song" <yunlong.song@hu <<
299 Contact: "Chao Yu" <yuchao0@huawei.com> <<
300 Description: Shows current reserved blocks <<
301 smaller than target_reserved_b <<
302 increase to target_reserved_bl <<
303 freed by user later. <<
304 <<
305 What: /sys/fs/f2fs/<disk>/gc_urgent <<
306 Date: August 2017 <<
307 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o <<
308 Description: Do background GC aggressively <<
309 gc urgent high(1): does GC for <<
310 gc_urgent_sleep_time and ignor <<
311 GC approach and turns SSR mode <<
312 gc urgent low(2): lowers the b <<
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 <<
319 What: /sys/fs/f2fs/<disk>/gc_urgent_ <<
320 Date: August 2017 <<
321 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o <<
322 Description: Controls sleep time of GC urge <<
323 <<
324 What: /sys/fs/f2fs/<disk>/readdir_ra <<
325 Date: November 2017 <<
326 Contact: "Sheng Yong" <shengyong1@huawei <<
327 Description: Controls readahead inode block <<
328 <<
329 What: /sys/fs/f2fs/<disk>/gc_pin_fil <<
330 Date: January 2018 <<
331 Contact: Jaegeuk Kim <jaegeuk@kernel.org <<
332 Description: This indicates how many GC can <<
333 file. If it exceeds this, F2FS <<
334 state. 2048 trials is set by d <<
335 <<
336 What: /sys/fs/f2fs/<disk>/extension_ <<
337 Date: February 2018 <<
338 Contact: "Chao Yu" <yuchao0@huawei.com> <<
339 Description: Used to control configure exte <<
340 - Query: cat /sys/fs/f2fs/<dis <<
341 - Add: echo '[h/c]extension' > <<
342 - Del: echo '[h/c]!extension' <<
343 - [h] means add/del hot file e <<
344 - [c] means add/del cold file <<
345 <<
346 What: /sys/fs/f2fs/<disk>/unusable <<
347 Date April 2019 <<
348 Contact: "Daniel Rosenberg" <drosen@goog <<
349 Description: If checkpoint=disable, it disp <<
350 are unusable. <<
351 If checkpoint=enable it displa <<
352 would be unusable if checkpoin <<
353 <<
354 What: /sys/fs/f2fs/<disk>/encoding <<
355 Date July 2019 <<
356 Contact: "Daniel Rosenberg" <drosen@goog <<
357 Description: Displays name and version of t <<
358 If no encoding is set, display <<
359 <<
360 What: /sys/fs/f2fs/<disk>/free_segme <<
361 Date: September 2019 <<
362 Contact: "Hridya Valsaraju" <hridya@goog <<
363 Description: Number of free segments in dis <<
364 <<
365 What: /sys/fs/f2fs/<disk>/cp_foregro <<
366 Date: September 2019 <<
367 Contact: "Hridya Valsaraju" <hridya@goog <<
368 Description: Number of checkpoint operation <<
369 CONFIG_F2FS_STAT_FS=y. <<
370 <<
371 What: /sys/fs/f2fs/<disk>/cp_backgro <<
372 Date: September 2019 <<
373 Contact: "Hridya Valsaraju" <hridya@goog <<
374 Description: Number of checkpoint operation <<
375 free segments. Available when <<
376 <<
377 What: /sys/fs/f2fs/<disk>/gc_foregro <<
378 Date: September 2019 <<
379 Contact: "Hridya Valsaraju" <hridya@goog <<
380 Description: Number of garbage collection o <<
381 Available when CONFIG_F2FS_STA <<
382 <<
383 What: /sys/fs/f2fs/<disk>/gc_backgro <<
384 Date: September 2019 <<
385 Contact: "Hridya Valsaraju" <hridya@goog <<
386 Description: Number of garbage collection o <<
387 Available when CONFIG_F2FS_STA <<
388 <<
389 What: /sys/fs/f2fs/<disk>/moved_bloc <<
390 Date: September 2019 <<
391 Contact: "Hridya Valsaraju" <hridya@goog <<
392 Description: Number of blocks moved by garb <<
393 Available when CONFIG_F2FS_STA <<
394 <<
395 What: /sys/fs/f2fs/<disk>/moved_bloc <<
396 Date: September 2019 <<
397 Contact: "Hridya Valsaraju" <hridya@goog <<
398 Description: Number of blocks moved by garb <<
399 Available when CONFIG_F2FS_STA <<
400 <<
401 What: /sys/fs/f2fs/<disk>/avg_vblock <<
402 Date: September 2019 <<
403 Contact: "Hridya Valsaraju" <hridya@goog <<
404 Description: Average number of valid blocks <<
405 Available when CONFIG_F2FS_STA <<
406 <<
407 What: /sys/fs/f2fs/<disk>/mounted_ti <<
408 Date: February 2020 <<
409 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o <<
410 Description: Show the mounted time in secs <<
411 <<
412 What: /sys/fs/f2fs/<disk>/data_io_fl <<
413 Date: April 2020 <<
414 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o <<
415 Description: Give a way to attach REQ_META| <<
416 given temperature-based bits. <<
417 <<
418 +-------------------+--------- <<
419 | REQ_META | REQ <<
420 +------+------+-----+------+-- <<
421 | 5 | 4 | 3 | 2 | <<
422 +------+------+-----+------+-- <<
423 | Cold | Warm | Hot | Cold | W <<
424 +------+------+-----+------+-- <<
425 <<
426 What: /sys/fs/f2fs/<disk>/node_io_fl <<
427 Date: June 2020 <<
428 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o <<
429 Description: Give a way to attach REQ_META| <<
430 given temperature-based bits. <<
431 <<
432 +-------------------+--------- <<
433 | REQ_META | REQ <<
434 +------+------+-----+------+-- <<
435 | 5 | 4 | 3 | 2 | <<
436 +------+------+-----+------+-- <<
437 | Cold | Warm | Hot | Cold | W <<
438 +------+------+-----+------+-- <<
439 <<
440 What: /sys/fs/f2fs/<disk>/iostat_per <<
441 Date: April 2020 <<
442 Contact: "Daeho Jeong" <daehojeong@googl <<
443 Description: Give a way to change iostat_pe <<
444 The new iostat trace gives sta <<
445 What: /sys/fs/f2fs/<disk>/max_io_byt <<
446 Date: December 2020 <<
447 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o <<
448 Description: This gives a control to limit <<
449 Default is zero, which will fo <<
450 whereas, if it has a certain b <<
451 bio larger than that size. <<
452 <<
453 What: /sys/fs/f2fs/<disk>/stat/sb_st <<
454 Date: December 2020 <<
455 Contact: "Chao Yu" <yuchao0@huawei.com> <<
456 Description: Show status of f2fs superblock <<
457 <<
458 ====== ===================== = <<
459 value sb status macro d <<
460 0x1 SBI_IS_DIRTY d <<
461 0x2 SBI_IS_CLOSE s <<
462 0x4 SBI_NEED_FSCK n <<
463 0x8 SBI_POR_DOING r <<
464 0x10 SBI_NEED_SB_WRITE n <<
465 0x20 SBI_NEED_CP n <<
466 0x40 SBI_IS_SHUTDOWN s <<
467 0x80 SBI_IS_RECOVERED r <<
468 0x100 SBI_CP_DISABLED C <<
469 0x200 SBI_CP_DISABLED_QUICK C <<
470 0x400 SBI_QUOTA_NEED_FLUSH n <<
471 0x800 SBI_QUOTA_SKIP_FLUSH s <<
472 0x1000 SBI_QUOTA_NEED_REPAIR q <<
473 0x2000 SBI_IS_RESIZEFS r <<
474 0x4000 SBI_IS_FREEZING f <<
475 ====== ===================== = <<
476 <<
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 <<
517 Date: January 2021 <<
518 Contact: "Daeho Jeong" <daehojeong@googl <<
519 Description: Give a way to change checkpoin <<
520 Its default value is "be,3", w <<
521 I/O priority "3". We can selec <<
522 and set the I/O priority withi <<
523 is necessary in between I/O cl <<
524 <<
525 What: /sys/fs/f2fs/<disk>/ovp_segmen <<
526 Date: March 2021 <<
527 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o <<
528 Description: Shows the number of overprovis <<
529 <<
530 What: /sys/fs/f2fs/<disk>/compr_writ <<
531 Date: March 2021 <<
532 Contact: "Daeho Jeong" <daehojeong@googl <<
533 Description: Show the block count written a <<
534 that when the compressed block <<
535 decrease. If you write "0" her <<
536 compr_written_block and compr_ <<
537 <<
538 What: /sys/fs/f2fs/<disk>/compr_save <<
539 Date: March 2021 <<
540 Contact: "Daeho Jeong" <daehojeong@googl <<
541 Description: Show the saved block count wit <<
542 that when the compressed block <<
543 decrease. If you write "0" her <<
544 compr_written_block and compr_ <<
545 <<
546 What: /sys/fs/f2fs/<disk>/compr_new_ <<
547 Date: March 2021 <<
548 Contact: "Daeho Jeong" <daehojeong@googl <<
549 Description: Show the count of inode newly <<
550 Note that when the compression <<
551 doesn't decrease. If you write <<
552 compr_new_inode to "0". <<
553 <<
554 What: /sys/fs/f2fs/<disk>/atgc_candi <<
555 Date: May 2021 <<
556 Contact: "Chao Yu" <yuchao0@huawei.com> <<
557 Description: When ATGC is on, it controls c <<
558 number of potential victim in <<
559 range of [0, 100], by default <<
560 <<
561 What: /sys/fs/f2fs/<disk>/atgc_candi <<
562 Date: May 2021 <<
563 Contact: "Chao Yu" <yuchao0@huawei.com> <<
564 Description: When ATGC is on, it controls c <<
565 number of potential victim in <<
566 initialized as 10 (sections). <<
567 <<
568 What: /sys/fs/f2fs/<disk>/atgc_age_w <<
569 Date: May 2021 <<
570 Contact: "Chao Yu" <yuchao0@huawei.com> <<
571 Description: When ATGC is on, it controls a <<
572 in between aging and valid blo <<
573 [0, 100], by default it was in <<
574 <<
575 What: /sys/fs/f2fs/<disk>/atgc_age_t <<
576 Date: May 2021 <<
577 Contact: "Chao Yu" <yuchao0@huawei.com> <<
578 Description: When ATGC is on, it controls a <<
579 candidates whose age is not be <<
580 initialized as 604800 seconds <<
581 <<
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 <<
589 Date: July 2021 <<
590 Contact: "Daeho Jeong" <daehojeong@googl <<
591 Description: Show how many segments have be <<
592 GC mode (0: GC normal, 1: GC i <<
593 3: GC idle AT, 4: GC urgent hi <<
594 You can re-initialize this val <<
595 <<
596 What: /sys/fs/f2fs/<disk>/gc_segment <<
597 Date: July 2021 <<
598 Contact: "Daeho Jeong" <daehojeong@googl <<
599 Description: You can control for which gc m <<
600 Refer to the description of th <<
601 <<
602 What: /sys/fs/f2fs/<disk>/seq_file_r <<
603 Date: July 2021 <<
604 Contact: "Daeho Jeong" <daehojeong@googl <<
605 Description: You can control the multiplier <<
606 between 2 (default) and 256 fo <<
607 <<
608 What: /sys/fs/f2fs/<disk>/max_fragme <<
609 Date: August 2021 <<
610 Contact: "Daeho Jeong" <daehojeong@googl <<
611 Description: With "mode=fragment:block" mou <<
612 f2fs will allocate 1..<max_fra <<
613 in the length of 1..<max_fragm <<
614 between 1..512 and the default <<
615 <<
616 What: /sys/fs/f2fs/<disk>/max_fragme <<
617 Date: August 2021 <<
618 Contact: "Daeho Jeong" <daehojeong@googl <<
619 Description: With "mode=fragment:block" mou <<
620 f2fs will allocate 1..<max_fra <<
621 in the length of 1..<max_fragm <<
622 between 1..512 and the default <<
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.