xref: /linux/Documentation/ABI/testing/sysfs-fs-f2fs (revision eebd36a408bb6fc5d7adbb4b8c6db993d0a850f8)
1b59d0baeSNamjae JeonWhat:		/sys/fs/f2fs/<disk>/gc_max_sleep_time
2b59d0baeSNamjae JeonDate:		July 2013
3b59d0baeSNamjae JeonContact:	"Namjae Jeon" <namjae.jeon@samsung.com>
4f5fa7c8bSHridya ValsarajuDescription:	Controls the maximum sleep time for gc_thread. Time
5b59d0baeSNamjae Jeon		is in milliseconds.
6b59d0baeSNamjae Jeon
7b59d0baeSNamjae JeonWhat:		/sys/fs/f2fs/<disk>/gc_min_sleep_time
8b59d0baeSNamjae JeonDate:		July 2013
9b59d0baeSNamjae JeonContact:	"Namjae Jeon" <namjae.jeon@samsung.com>
10f5fa7c8bSHridya ValsarajuDescription:	Controls the minimum sleep time for gc_thread. Time
11b59d0baeSNamjae Jeon		is in milliseconds.
12b59d0baeSNamjae Jeon
13b59d0baeSNamjae JeonWhat:		/sys/fs/f2fs/<disk>/gc_no_gc_sleep_time
14b59d0baeSNamjae JeonDate:		July 2013
15b59d0baeSNamjae JeonContact:	"Namjae Jeon" <namjae.jeon@samsung.com>
16f5fa7c8bSHridya ValsarajuDescription:	Controls the default sleep time for gc_thread. Time
17b59d0baeSNamjae Jeon		is in milliseconds.
18d2dc095fSNamjae Jeon
19d2dc095fSNamjae JeonWhat:		/sys/fs/f2fs/<disk>/gc_idle
20d2dc095fSNamjae JeonDate:		July 2013
21d2dc095fSNamjae JeonContact:	"Namjae Jeon" <namjae.jeon@samsung.com>
22f5fa7c8bSHridya ValsarajuDescription:	Controls the victim selection policy for garbage collection.
2354a19b4dSMauro Carvalho Chehab		Setting gc_idle = 0(default) will disable this option. Setting:
2454a19b4dSMauro Carvalho Chehab
2554a19b4dSMauro Carvalho Chehab		===========  ===============================================
26f5fa7c8bSHridya Valsaraju		gc_idle = 1  will select the Cost Benefit approach & setting
27093749e2SChao Yu		gc_idle = 2  will select the greedy approach & setting
28093749e2SChao Yu		gc_idle = 3  will select the age-threshold based approach.
2954a19b4dSMauro Carvalho Chehab		===========  ===============================================
303bac380cSJaegeuk Kim
313bac380cSJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/reclaim_segments
323bac380cSJaegeuk KimDate:		October 2013
333bac380cSJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk.kim@samsung.com>
34f5fa7c8bSHridya ValsarajuDescription:	This parameter controls the number of prefree segments to be
35f5fa7c8bSHridya Valsaraju		reclaimed. If the number of prefree segments is larger than
36f5fa7c8bSHridya Valsaraju		the number of segments in the proportion to the percentage
37f5fa7c8bSHridya Valsaraju		over total volume size, f2fs tries to conduct checkpoint to
38f5fa7c8bSHridya Valsaraju		reclaim the prefree segments to free segments.
39f5fa7c8bSHridya Valsaraju		By default, 5% over total # of segments.
403bac380cSJaegeuk Kim
41f5fa7c8bSHridya ValsarajuWhat:		/sys/fs/f2fs/<disk>/main_blkaddr
42a4db59acSJaegeuk KimDate:		November 2019
43a4db59acSJaegeuk KimContact:	"Ramon Pantin" <pantin@google.com>
44b35d71b9SYangtao LiDescription:	Shows first block address of MAIN area.
45a4db59acSJaegeuk Kim
463bac380cSJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/ipu_policy
473bac380cSJaegeuk KimDate:		November 2013
483bac380cSJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk.kim@samsung.com>
49f5fa7c8bSHridya ValsarajuDescription:	Controls the in-place-update policy.
50f5fa7c8bSHridya Valsaraju		updates in f2fs. User can set:
5154a19b4dSMauro Carvalho Chehab
5254a19b4dSMauro Carvalho Chehab		====  =================
5354a19b4dSMauro Carvalho Chehab		0x01  F2FS_IPU_FORCE
5454a19b4dSMauro Carvalho Chehab		0x02  F2FS_IPU_SSR
5554a19b4dSMauro Carvalho Chehab		0x04  F2FS_IPU_UTIL
5654a19b4dSMauro Carvalho Chehab		0x08  F2FS_IPU_SSR_UTIL
5754a19b4dSMauro Carvalho Chehab		0x10  F2FS_IPU_FSYNC
581018a546SChao Yu		0x20  F2FS_IPU_ASYNC
5954a19b4dSMauro Carvalho Chehab		0x40  F2FS_IPU_NOCACHE
601018a546SChao Yu		0x80  F2FS_IPU_HONOR_OPU_WRITE
6154a19b4dSMauro Carvalho Chehab		====  =================
6254a19b4dSMauro Carvalho Chehab
63f5fa7c8bSHridya Valsaraju		Refer segment.h for details.
643bac380cSJaegeuk Kim
653bac380cSJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/min_ipu_util
663bac380cSJaegeuk KimDate:		November 2013
673bac380cSJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk.kim@samsung.com>
68f5fa7c8bSHridya ValsarajuDescription:	Controls the FS utilization condition for the in-place-update
69f5fa7c8bSHridya Valsaraju		policies. It is used by F2FS_IPU_UTIL and F2FS_IPU_SSR_UTIL policies.
703bac380cSJaegeuk Kim
71c1ce1b02SJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/min_fsync_blocks
72c1ce1b02SJaegeuk KimDate:		September 2014
73c1ce1b02SJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
74f5fa7c8bSHridya ValsarajuDescription:	Controls the dirty page count condition for the in-place-update
75c1ce1b02SJaegeuk Kim		policies.
76c1ce1b02SJaegeuk Kim
77853137ceSJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/min_seq_blocks
78853137ceSJaegeuk KimDate:		August 2018
79853137ceSJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
80f5fa7c8bSHridya ValsarajuDescription:	Controls the dirty page count condition for batched sequential
81f5fa7c8bSHridya Valsaraju		writes in writepages.
82853137ceSJaegeuk Kim
83b32d73abSChao YuWhat:		/sys/fs/f2fs/<disk>/min_hot_blocks
84b32d73abSChao YuDate:		March 2017
85b32d73abSChao YuContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
86f5fa7c8bSHridya ValsarajuDescription:	Controls the dirty page count condition for redefining hot data.
87b32d73abSChao Yu
88a2a12b67SChao YuWhat:		/sys/fs/f2fs/<disk>/min_ssr_sections
89a2a12b67SChao YuDate:		October 2017
90a2a12b67SChao YuContact:	"Chao Yu" <yuchao0@huawei.com>
91f5fa7c8bSHridya ValsarajuDescription:	Controls the free section threshold to trigger SSR allocation.
92f5fa7c8bSHridya Valsaraju		If this is large, SSR mode will be enabled early.
93a2a12b67SChao Yu
943bac380cSJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/max_small_discards
953bac380cSJaegeuk KimDate:		November 2013
963bac380cSJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk.kim@samsung.com>
97f5fa7c8bSHridya ValsarajuDescription:	Controls the issue rate of discard commands that consist of small
98f5fa7c8bSHridya Valsaraju		blocks less than 2MB. The candidates to be discarded are cached until
99f5fa7c8bSHridya Valsaraju		checkpoint is triggered, and issued during the checkpoint.
100f5fa7c8bSHridya Valsaraju		By default, it is disabled with 0.
1013bac380cSJaegeuk Kim
102c46867e9SYangtao LiWhat:		/sys/fs/f2fs/<disk>/max_ordered_discard
103c46867e9SYangtao LiDate:		October 2022
104c46867e9SYangtao LiContact:	"Yangtao Li" <frank.li@vivo.com>
105c46867e9SYangtao LiDescription:	Controls the maximum ordered discard, the unit size is one block(4KB).
106c46867e9SYangtao Li		Set it to 16 by default.
107c46867e9SYangtao Li
108b2e4a2b3SKonstantin VyshetskyWhat:		/sys/fs/f2fs/<disk>/max_discard_request
109b2e4a2b3SKonstantin VyshetskyDate:		December 2021
110b2e4a2b3SKonstantin VyshetskyContact:	"Konstantin Vyshetsky" <vkon@google.com>
111b2e4a2b3SKonstantin VyshetskyDescription:	Controls the number of discards a thread will issue at a time.
112b2e4a2b3SKonstantin Vyshetsky		Higher number will allow the discard thread to finish its work
113b2e4a2b3SKonstantin Vyshetsky		faster, at the cost of higher latency for incomming I/O.
114b2e4a2b3SKonstantin Vyshetsky
115b2e4a2b3SKonstantin VyshetskyWhat:		/sys/fs/f2fs/<disk>/min_discard_issue_time
116b2e4a2b3SKonstantin VyshetskyDate:		December 2021
117b2e4a2b3SKonstantin VyshetskyContact:	"Konstantin Vyshetsky" <vkon@google.com>
118b2e4a2b3SKonstantin VyshetskyDescription:	Controls the interval the discard thread will wait between
119b2e4a2b3SKonstantin Vyshetsky		issuing discard requests when there are discards to be issued and
120b2e4a2b3SKonstantin Vyshetsky		no I/O aware interruptions occur.
121b2e4a2b3SKonstantin Vyshetsky
122b2e4a2b3SKonstantin VyshetskyWhat:		/sys/fs/f2fs/<disk>/mid_discard_issue_time
123b2e4a2b3SKonstantin VyshetskyDate:		December 2021
124b2e4a2b3SKonstantin VyshetskyContact:	"Konstantin Vyshetsky" <vkon@google.com>
125b2e4a2b3SKonstantin VyshetskyDescription:	Controls the interval the discard thread will wait between
126b2e4a2b3SKonstantin Vyshetsky		issuing discard requests when there are discards to be issued and
127b2e4a2b3SKonstantin Vyshetsky		an I/O aware interruption occurs.
128b2e4a2b3SKonstantin Vyshetsky
129b2e4a2b3SKonstantin VyshetskyWhat:		/sys/fs/f2fs/<disk>/max_discard_issue_time
130b2e4a2b3SKonstantin VyshetskyDate:		December 2021
131b2e4a2b3SKonstantin VyshetskyContact:	"Konstantin Vyshetsky" <vkon@google.com>
132b2e4a2b3SKonstantin VyshetskyDescription:	Controls the interval the discard thread will wait when there are
133b2e4a2b3SKonstantin Vyshetsky		no discard operations to be issued.
134b2e4a2b3SKonstantin Vyshetsky
135969d1b18SChao YuWhat:		/sys/fs/f2fs/<disk>/discard_granularity
136969d1b18SChao YuDate:		July 2017
137969d1b18SChao YuContact:	"Chao Yu" <yuchao0@huawei.com>
138f5fa7c8bSHridya ValsarajuDescription:	Controls discard granularity of inner discard thread. Inner thread
139969d1b18SChao Yu		will not issue discards with size that is smaller than granularity.
140f5fa7c8bSHridya Valsaraju		The unit size is one block(4KB), now only support configuring
141f5fa7c8bSHridya Valsaraju		in range of [1, 512]. Default value is 4(=16KB).
142969d1b18SChao Yu
14303f2c02dSJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/umount_discard_timeout
14403f2c02dSJaegeuk KimDate:		January 2019
14503f2c02dSJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
146f5fa7c8bSHridya ValsarajuDescription:	Set timeout to issue discard commands during umount.
14703f2c02dSJaegeuk Kim	        Default: 5 secs
14803f2c02dSJaegeuk Kim
149ae2e2804SJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/pending_discard
150ae2e2804SJaegeuk KimDate:		November 2021
151ae2e2804SJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
152ae2e2804SJaegeuk KimDescription:	Shows the number of pending discard commands in the queue.
153ae2e2804SJaegeuk Kim
1543bac380cSJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/max_victim_search
1553bac380cSJaegeuk KimDate:		January 2014
1563bac380cSJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk.kim@samsung.com>
157f5fa7c8bSHridya ValsarajuDescription:	Controls the number of trials to find a victim segment
158f5fa7c8bSHridya Valsaraju		when conducting SSR and cleaning operations. The default value
159f5fa7c8bSHridya Valsaraju		is 4096 which covers 8GB block address range.
160cdfc41c1SJaegeuk Kim
16134655575SChao YuWhat:		/sys/fs/f2fs/<disk>/migration_granularity
16234655575SChao YuDate:		October 2018
16334655575SChao YuContact:	"Chao Yu" <yuchao0@huawei.com>
164f5fa7c8bSHridya ValsarajuDescription:	Controls migration granularity of garbage collection on large
16534655575SChao Yu		section, it can let GC move partial segment{s} of one section
16634655575SChao Yu		in one GC cycle, so that dispersing heavy overhead GC to
16734655575SChao Yu		multiple lightweight one.
16834655575SChao Yu
16991796825SJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/dir_level
17091796825SJaegeuk KimDate:		March 2014
17191796825SJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk.kim@samsung.com>
172f5fa7c8bSHridya ValsarajuDescription:	Controls the directory level for large directory. If a
173f5fa7c8bSHridya Valsaraju		directory has a number of files, it can reduce the file lookup
174f5fa7c8bSHridya Valsaraju		latency by increasing this dir_level value. Otherwise, it
175f5fa7c8bSHridya Valsaraju		needs to decrease this value to reduce the space overhead.
176f5fa7c8bSHridya Valsaraju		The default value is 0.
17791796825SJaegeuk Kim
178cdfc41c1SJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/ram_thresh
179cdfc41c1SJaegeuk KimDate:		March 2014
180cdfc41c1SJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk.kim@samsung.com>
181f5fa7c8bSHridya ValsarajuDescription:	Controls the memory footprint used by free nids and cached
182f5fa7c8bSHridya Valsaraju		nat entries. By default, 1 is set, which indicates
183f5fa7c8bSHridya Valsaraju		10 MB / 1 GB RAM.
184bba681cbSJaegeuk Kim
1856f6d9fe2SChao YuWhat:		/sys/fs/f2fs/<disk>/batched_trim_sections
186bba681cbSJaegeuk KimDate:		February 2015
187bba681cbSJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
188f5fa7c8bSHridya ValsarajuDescription:	Controls the trimming rate in batch mode.
189377224c4SChao Yu		<deprecated>
19060b99b48SJaegeuk Kim
19160b99b48SJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/cp_interval
19260b99b48SJaegeuk KimDate:		October 2015
19360b99b48SJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
194f5fa7c8bSHridya ValsarajuDescription:	Controls the checkpoint timing, set to 60 seconds by default.
195ea1a29a0SChao Yu
196d0239e1bSJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/idle_interval
197d0239e1bSJaegeuk KimDate:		January 2016
198d0239e1bSJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
199f5fa7c8bSHridya ValsarajuDescription:	Controls the idle timing of system, if there is no FS operation
200f5fa7c8bSHridya Valsaraju		during given interval.
201f5fa7c8bSHridya Valsaraju		Set to 5 seconds by default.
202a7d10cf3SSahitya Tummala
203a7d10cf3SSahitya TummalaWhat:		/sys/fs/f2fs/<disk>/discard_idle_interval
204a7d10cf3SSahitya TummalaDate:		September 2018
205a7d10cf3SSahitya TummalaContact:	"Chao Yu" <yuchao0@huawei.com>
206a7d10cf3SSahitya TummalaContact:	"Sahitya Tummala" <stummala@codeaurora.org>
207f5fa7c8bSHridya ValsarajuDescription:	Controls the idle timing of discard thread given
208f5fa7c8bSHridya Valsaraju		this time interval.
209f5fa7c8bSHridya Valsaraju		Default is 5 secs.
210a7d10cf3SSahitya Tummala
211a7d10cf3SSahitya TummalaWhat:		/sys/fs/f2fs/<disk>/gc_idle_interval
212a7d10cf3SSahitya TummalaDate:		September 2018
213a7d10cf3SSahitya TummalaContact:	"Chao Yu" <yuchao0@huawei.com>
214a7d10cf3SSahitya TummalaContact:	"Sahitya Tummala" <stummala@codeaurora.org>
215f5fa7c8bSHridya ValsarajuDescription:    Controls the idle timing for gc path. Set to 5 seconds by default.
216d0239e1bSJaegeuk Kim
217b32d73abSChao YuWhat:		/sys/fs/f2fs/<disk>/iostat_enable
218b32d73abSChao YuDate:		August 2017
219b32d73abSChao YuContact:	"Chao Yu" <yuchao0@huawei.com>
220f5fa7c8bSHridya ValsarajuDescription:	Controls to enable/disable IO stat.
221b32d73abSChao Yu
222ea1a29a0SChao YuWhat:		/sys/fs/f2fs/<disk>/ra_nid_pages
223ea1a29a0SChao YuDate:		October 2015
224ea1a29a0SChao YuContact:	"Chao Yu" <chao2.yu@samsung.com>
225f5fa7c8bSHridya ValsarajuDescription:	Controls the count of nid pages to be readaheaded.
226f5fa7c8bSHridya Valsaraju		When building free nids, F2FS reads NAT blocks ahead for
227f5fa7c8bSHridya Valsaraju		speed up. Default is 0.
2282304cb0cSChao Yu
2292304cb0cSChao YuWhat:		/sys/fs/f2fs/<disk>/dirty_nats_ratio
2302304cb0cSChao YuDate:		January 2016
2312304cb0cSChao YuContact:	"Chao Yu" <chao2.yu@samsung.com>
232f5fa7c8bSHridya ValsarajuDescription:	Controls dirty nat entries ratio threshold, if current
2332304cb0cSChao Yu		ratio exceeds configured threshold, checkpoint will
2342304cb0cSChao Yu		be triggered for flushing dirty nat entries.
2358f1dbbbbSShuoran Liu
2368f1dbbbbSShuoran LiuWhat:		/sys/fs/f2fs/<disk>/lifetime_write_kbytes
2378f1dbbbbSShuoran LiuDate:		January 2016
2388f1dbbbbSShuoran LiuContact:	"Shuoran Liu" <liushuoran@huawei.com>
239f5fa7c8bSHridya ValsarajuDescription:	Shows total written kbytes issued to disk.
24056412894SChao Yu
2419ac19faaSEric BiggersWhat:		/sys/fs/f2fs/<disk>/features
242b32d73abSChao YuDate:		July 2017
243b32d73abSChao YuContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
244*eebd36a4SJaegeuk KimDescription:	<deprecated: should use /sys/fs/f2fs/<disk>/feature_list/>
2454c89b53dSJaegeuk Kim		Shows all enabled features in current device.
2464c89b53dSJaegeuk Kim		Supported features:
2474c89b53dSJaegeuk Kim		encryption, blkzoned, extra_attr, projquota, inode_checksum,
2484c89b53dSJaegeuk Kim		flexible_inline_xattr, quota_ino, inode_crtime, lost_found,
2494c89b53dSJaegeuk Kim		verity, sb_checksum, casefold, readonly, compression, pin_file.
2504c89b53dSJaegeuk Kim
2514c89b53dSJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/feature_list/
2524c89b53dSJaegeuk KimDate:		June 2021
2534c89b53dSJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
2544c89b53dSJaegeuk KimDescription:	Expand /sys/fs/f2fs/<disk>/features to meet sysfs rule.
2554c89b53dSJaegeuk Kim		Supported on-disk features:
2564c89b53dSJaegeuk Kim		encryption, block_zoned (aka blkzoned), extra_attr,
2574c89b53dSJaegeuk Kim		project_quota (aka projquota), inode_checksum,
2584c89b53dSJaegeuk Kim		flexible_inline_xattr, quota_ino, inode_crtime, lost_found,
2594c89b53dSJaegeuk Kim		verity, sb_checksum, casefold, readonly, compression.
2604c89b53dSJaegeuk Kim		Note that, pin_file is moved into /sys/fs/f2fs/features/.
2614c89b53dSJaegeuk Kim
2624c89b53dSJaegeuk KimWhat:		/sys/fs/f2fs/features/
2634c89b53dSJaegeuk KimDate:		July 2017
2644c89b53dSJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
2654c89b53dSJaegeuk KimDescription:	Shows all enabled kernel features.
2664c89b53dSJaegeuk Kim		Supported features:
2674c89b53dSJaegeuk Kim		encryption, block_zoned, extra_attr, project_quota,
2684c89b53dSJaegeuk Kim		inode_checksum, flexible_inline_xattr, quota_ino,
2694c89b53dSJaegeuk Kim		inode_crtime, lost_found, verity, sb_checksum,
2704c89b53dSJaegeuk Kim		casefold, readonly, compression, test_dummy_encryption_v2,
2714c89b53dSJaegeuk Kim		atomic_write, pin_file, encrypted_casefold.
272b32d73abSChao Yu
27356412894SChao YuWhat:		/sys/fs/f2fs/<disk>/inject_rate
27456412894SChao YuDate:		May 2016
27556412894SChao YuContact:	"Sheng Yong" <shengyong1@huawei.com>
276f5fa7c8bSHridya ValsarajuDescription:	Controls the injection rate of arbitrary faults.
27756412894SChao Yu
27856412894SChao YuWhat:		/sys/fs/f2fs/<disk>/inject_type
27956412894SChao YuDate:		May 2016
28056412894SChao YuContact:	"Sheng Yong" <shengyong1@huawei.com>
281f5fa7c8bSHridya ValsarajuDescription:	Controls the injection type of arbitrary faults.
282f5fa7c8bSHridya Valsaraju
283f5fa7c8bSHridya ValsarajuWhat:		/sys/fs/f2fs/<disk>/dirty_segments
284f5fa7c8bSHridya ValsarajuDate:		October 2017
285f5fa7c8bSHridya ValsarajuContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
286f5fa7c8bSHridya ValsarajuDescription:	Shows the number of dirty segments.
287daeb433eSChao Yu
288daeb433eSChao YuWhat:		/sys/fs/f2fs/<disk>/reserved_blocks
289daeb433eSChao YuDate:		June 2017
290daeb433eSChao YuContact:	"Chao Yu" <yuchao0@huawei.com>
291f5fa7c8bSHridya ValsarajuDescription:	Controls target reserved blocks in system, the threshold
29280d42145SYunlong Song		is soft, it could exceed current available user space.
29380d42145SYunlong Song
29480d42145SYunlong SongWhat:		/sys/fs/f2fs/<disk>/current_reserved_blocks
29580d42145SYunlong SongDate:		October 2017
29680d42145SYunlong SongContact:	"Yunlong Song" <yunlong.song@huawei.com>
29780d42145SYunlong SongContact:	"Chao Yu" <yuchao0@huawei.com>
298f5fa7c8bSHridya ValsarajuDescription:	Shows current reserved blocks in system, it may be temporarily
29980d42145SYunlong Song		smaller than target_reserved_blocks, but will gradually
30080d42145SYunlong Song		increase to target_reserved_blocks when more free blocks are
30180d42145SYunlong Song		freed by user later.
302d9872a69SJaegeuk Kim
303d9872a69SJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/gc_urgent
304d9872a69SJaegeuk KimDate:		August 2017
305d9872a69SJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
306d98af5f4SDaeho JeongDescription:	Do background GC aggressively when set. Set to 0 by default.
307d98af5f4SDaeho Jeong		gc urgent high(1): does GC forcibly in a period of given
308d98af5f4SDaeho Jeong		gc_urgent_sleep_time and ignores I/O idling check. uses greedy
309d98af5f4SDaeho Jeong		GC approach and turns SSR mode on.
310d98af5f4SDaeho Jeong		gc urgent low(2): lowers the bar of checking I/O idling in
311d98af5f4SDaeho Jeong		order to process outstanding discard commands and GC a
312d98af5f4SDaeho Jeong		little bit aggressively. uses cost benefit GC approach.
313d98af5f4SDaeho Jeong		gc urgent mid(3): does GC forcibly in a period of given
314d98af5f4SDaeho Jeong		gc_urgent_sleep_time and executes a mid level of I/O idling check.
315d98af5f4SDaeho Jeong		uses cost benefit GC approach.
316d9872a69SJaegeuk Kim
317d9872a69SJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/gc_urgent_sleep_time
318d9872a69SJaegeuk KimDate:		August 2017
319d9872a69SJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
320f5fa7c8bSHridya ValsarajuDescription:	Controls sleep time of GC urgent mode. Set to 500ms by default.
321f6df8f23SSheng Yong
322f6df8f23SSheng YongWhat:		/sys/fs/f2fs/<disk>/readdir_ra
323f6df8f23SSheng YongDate:		November 2017
324f6df8f23SSheng YongContact:	"Sheng Yong" <shengyong1@huawei.com>
325f5fa7c8bSHridya ValsarajuDescription:	Controls readahead inode block in readdir. Enabled by default.
326f5fa7c8bSHridya Valsaraju
327f5fa7c8bSHridya ValsarajuWhat:		/sys/fs/f2fs/<disk>/gc_pin_file_thresh
328f5fa7c8bSHridya ValsarajuDate:		January 2018
329f5fa7c8bSHridya ValsarajuContact:	Jaegeuk Kim <jaegeuk@kernel.org>
330f5fa7c8bSHridya ValsarajuDescription:	This indicates how many GC can be failed for the pinned
331f5fa7c8bSHridya Valsaraju		file. If it exceeds this, F2FS doesn't guarantee its pinning
332f5fa7c8bSHridya Valsaraju		state. 2048 trials is set by default.
333846ae671SChao Yu
334846ae671SChao YuWhat:		/sys/fs/f2fs/<disk>/extension_list
335846ae671SChao YuDate:		Feburary 2018
336846ae671SChao YuContact:	"Chao Yu" <yuchao0@huawei.com>
337f5fa7c8bSHridya ValsarajuDescription:	Used to control configure extension list:
338846ae671SChao Yu		- Query: cat /sys/fs/f2fs/<disk>/extension_list
339b6a06cbbSChao Yu		- Add: echo '[h/c]extension' > /sys/fs/f2fs/<disk>/extension_list
340b6a06cbbSChao Yu		- Del: echo '[h/c]!extension' > /sys/fs/f2fs/<disk>/extension_list
341b6a06cbbSChao Yu		- [h] means add/del hot file extension
342b6a06cbbSChao Yu		- [c] means add/del cold file extension
3434d3aed70SDaniel Rosenberg
3444d3aed70SDaniel RosenbergWhat:		/sys/fs/f2fs/<disk>/unusable
3454d3aed70SDaniel RosenbergDate		April 2019
3464d3aed70SDaniel RosenbergContact:	"Daniel Rosenberg" <drosen@google.com>
347f5fa7c8bSHridya ValsarajuDescription:	If checkpoint=disable, it displays the number of blocks that
348f5fa7c8bSHridya Valsaraju		are unusable.
349c67c8c0fSxuyehan		If checkpoint=enable it displays the number of blocks that
350f5fa7c8bSHridya Valsaraju		would be unusable if checkpoint=disable were to be set.
3515aba5430SDaniel Rosenberg
3525aba5430SDaniel RosenbergWhat:		/sys/fs/f2fs/<disk>/encoding
3535aba5430SDaniel RosenbergDate		July 2019
3545aba5430SDaniel RosenbergContact:	"Daniel Rosenberg" <drosen@google.com>
355f5fa7c8bSHridya ValsarajuDescription:	Displays name and version of the encoding set for the filesystem.
3565aba5430SDaniel Rosenberg		If no encoding is set, displays (none)
357fc7100eaSHridya Valsaraju
358fc7100eaSHridya ValsarajuWhat:		/sys/fs/f2fs/<disk>/free_segments
359fc7100eaSHridya ValsarajuDate:		September 2019
360fc7100eaSHridya ValsarajuContact:	"Hridya Valsaraju" <hridya@google.com>
361fc7100eaSHridya ValsarajuDescription:	Number of free segments in disk.
362fc7100eaSHridya Valsaraju
363fc7100eaSHridya ValsarajuWhat:		/sys/fs/f2fs/<disk>/cp_foreground_calls
364fc7100eaSHridya ValsarajuDate:		September 2019
365fc7100eaSHridya ValsarajuContact:	"Hridya Valsaraju" <hridya@google.com>
366fc7100eaSHridya ValsarajuDescription:	Number of checkpoint operations performed on demand. Available when
367fc7100eaSHridya Valsaraju		CONFIG_F2FS_STAT_FS=y.
368fc7100eaSHridya Valsaraju
369fc7100eaSHridya ValsarajuWhat:		/sys/fs/f2fs/<disk>/cp_background_calls
370fc7100eaSHridya ValsarajuDate:		September 2019
371fc7100eaSHridya ValsarajuContact:	"Hridya Valsaraju" <hridya@google.com>
372fc7100eaSHridya ValsarajuDescription:	Number of checkpoint operations performed in the background to
373fc7100eaSHridya Valsaraju		free segments. Available when CONFIG_F2FS_STAT_FS=y.
374fc7100eaSHridya Valsaraju
375fc7100eaSHridya ValsarajuWhat:		/sys/fs/f2fs/<disk>/gc_foreground_calls
376fc7100eaSHridya ValsarajuDate:		September 2019
377fc7100eaSHridya ValsarajuContact:	"Hridya Valsaraju" <hridya@google.com>
378fc7100eaSHridya ValsarajuDescription:	Number of garbage collection operations performed on demand.
379fc7100eaSHridya Valsaraju		Available when CONFIG_F2FS_STAT_FS=y.
380fc7100eaSHridya Valsaraju
381fc7100eaSHridya ValsarajuWhat:		/sys/fs/f2fs/<disk>/gc_background_calls
382fc7100eaSHridya ValsarajuDate:		September 2019
383fc7100eaSHridya ValsarajuContact:	"Hridya Valsaraju" <hridya@google.com>
384fc7100eaSHridya ValsarajuDescription:	Number of garbage collection operations triggered in background.
385fc7100eaSHridya Valsaraju		Available when CONFIG_F2FS_STAT_FS=y.
386fc7100eaSHridya Valsaraju
387fc7100eaSHridya ValsarajuWhat:		/sys/fs/f2fs/<disk>/moved_blocks_foreground
388fc7100eaSHridya ValsarajuDate:		September 2019
389fc7100eaSHridya ValsarajuContact:	"Hridya Valsaraju" <hridya@google.com>
390fc7100eaSHridya ValsarajuDescription:	Number of blocks moved by garbage collection in foreground.
391fc7100eaSHridya Valsaraju		Available when CONFIG_F2FS_STAT_FS=y.
392fc7100eaSHridya Valsaraju
393fc7100eaSHridya ValsarajuWhat:		/sys/fs/f2fs/<disk>/moved_blocks_background
394fc7100eaSHridya ValsarajuDate:		September 2019
395fc7100eaSHridya ValsarajuContact:	"Hridya Valsaraju" <hridya@google.com>
396fc7100eaSHridya ValsarajuDescription:	Number of blocks moved by garbage collection in background.
397fc7100eaSHridya Valsaraju		Available when CONFIG_F2FS_STAT_FS=y.
398fc7100eaSHridya Valsaraju
399fc7100eaSHridya ValsarajuWhat:		/sys/fs/f2fs/<disk>/avg_vblocks
400fc7100eaSHridya ValsarajuDate:		September 2019
401fc7100eaSHridya ValsarajuContact:	"Hridya Valsaraju" <hridya@google.com>
402fc7100eaSHridya ValsarajuDescription:	Average number of valid blocks.
403fc7100eaSHridya Valsaraju		Available when CONFIG_F2FS_STAT_FS=y.
404a7e679b5SJaegeuk Kim
405a7e679b5SJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/mounted_time_sec
406a7e679b5SJaegeuk KimDate:		February 2020
407a7e679b5SJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
408a7e679b5SJaegeuk KimDescription:	Show the mounted time in secs of this partition.
409da9953b7SJaegeuk Kim
410da9953b7SJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/data_io_flag
411da9953b7SJaegeuk KimDate:		April 2020
412da9953b7SJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
413da9953b7SJaegeuk KimDescription:	Give a way to attach REQ_META|FUA to data writes
414da9953b7SJaegeuk Kim		given temperature-based bits. Now the bits indicate:
41554a19b4dSMauro Carvalho Chehab
41654a19b4dSMauro Carvalho Chehab		+-------------------+-------------------+
41754a19b4dSMauro Carvalho Chehab		|      REQ_META     |      REQ_FUA      |
41854a19b4dSMauro Carvalho Chehab		+------+------+-----+------+------+-----+
41954a19b4dSMauro Carvalho Chehab		|    5 |    4 |   3 |    2 |    1 |   0 |
42054a19b4dSMauro Carvalho Chehab		+------+------+-----+------+------+-----+
42154a19b4dSMauro Carvalho Chehab		| Cold | Warm | Hot | Cold | Warm | Hot |
42254a19b4dSMauro Carvalho Chehab		+------+------+-----+------+------+-----+
4232bc4bea3SDaeho Jeong
42432b6aba8SJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/node_io_flag
42532b6aba8SJaegeuk KimDate:		June 2020
42632b6aba8SJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
42732b6aba8SJaegeuk KimDescription:	Give a way to attach REQ_META|FUA to node writes
42832b6aba8SJaegeuk Kim		given temperature-based bits. Now the bits indicate:
42954a19b4dSMauro Carvalho Chehab
43054a19b4dSMauro Carvalho Chehab		+-------------------+-------------------+
43154a19b4dSMauro Carvalho Chehab		|      REQ_META     |      REQ_FUA      |
43254a19b4dSMauro Carvalho Chehab		+------+------+-----+------+------+-----+
43354a19b4dSMauro Carvalho Chehab		|    5 |    4 |   3 |    2 |    1 |   0 |
43454a19b4dSMauro Carvalho Chehab		+------+------+-----+------+------+-----+
43554a19b4dSMauro Carvalho Chehab		| Cold | Warm | Hot | Cold | Warm | Hot |
43654a19b4dSMauro Carvalho Chehab		+------+------+-----+------+------+-----+
43732b6aba8SJaegeuk Kim
4382bc4bea3SDaeho JeongWhat:		/sys/fs/f2fs/<disk>/iostat_period_ms
4392bc4bea3SDaeho JeongDate:		April 2020
4402bc4bea3SDaeho JeongContact:	"Daeho Jeong" <daehojeong@google.com>
4412bc4bea3SDaeho JeongDescription:	Give a way to change iostat_period time. 3secs by default.
4422bc4bea3SDaeho Jeong		The new iostat trace gives stats gap given the period.
44310208567SJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/max_io_bytes
44410208567SJaegeuk KimDate:		December 2020
44510208567SJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
44610208567SJaegeuk KimDescription:	This gives a control to limit the bio size in f2fs.
44710208567SJaegeuk Kim		Default is zero, which will follow underlying block layer limit,
44810208567SJaegeuk Kim		whereas, if it has a certain bytes value, f2fs won't submit a
44910208567SJaegeuk Kim		bio larger than that size.
4500bfe9f79SChao Yu
4510bfe9f79SChao YuWhat:		/sys/fs/f2fs/<disk>/stat/sb_status
4520bfe9f79SChao YuDate:		December 2020
4530bfe9f79SChao YuContact:	"Chao Yu" <yuchao0@huawei.com>
4540bfe9f79SChao YuDescription:	Show status of f2fs superblock in real time.
4550bfe9f79SChao Yu
4560bfe9f79SChao Yu		====== ===================== =================================
4570bfe9f79SChao Yu		value  sb status macro       description
4580bfe9f79SChao Yu		0x1    SBI_IS_DIRTY          dirty flag for checkpoint
4590bfe9f79SChao Yu		0x2    SBI_IS_CLOSE          specify unmounting
4600bfe9f79SChao Yu		0x4    SBI_NEED_FSCK         need fsck.f2fs to fix
4610bfe9f79SChao Yu		0x8    SBI_POR_DOING         recovery is doing or not
4620bfe9f79SChao Yu		0x10   SBI_NEED_SB_WRITE     need to recover superblock
4630bfe9f79SChao Yu		0x20   SBI_NEED_CP           need to checkpoint
4640bfe9f79SChao Yu		0x40   SBI_IS_SHUTDOWN       shutdown by ioctl
4650bfe9f79SChao Yu		0x80   SBI_IS_RECOVERED      recovered orphan/data
4660bfe9f79SChao Yu		0x100  SBI_CP_DISABLED       CP was disabled last mount
4670bfe9f79SChao Yu		0x200  SBI_CP_DISABLED_QUICK CP was disabled quickly
4680bfe9f79SChao Yu		0x400  SBI_QUOTA_NEED_FLUSH  need to flush quota info in CP
4690bfe9f79SChao Yu		0x800  SBI_QUOTA_SKIP_FLUSH  skip flushing quota in current CP
4700bfe9f79SChao Yu		0x1000 SBI_QUOTA_NEED_REPAIR quota file may be corrupted
4710bfe9f79SChao Yu		0x2000 SBI_IS_RESIZEFS       resizefs is in process
472ba900534SJaegeuk Kim		0x4000 SBI_IS_FREEZING       freefs is in process
4730bfe9f79SChao Yu		====== ===================== =================================
474e6592066SDaeho Jeong
475718693c8SChao YuWhat:		/sys/fs/f2fs/<disk>/stat/cp_status
476718693c8SChao YuDate:		September 2022
477718693c8SChao YuContact:	"Chao Yu" <chao.yu@oppo.com>
478718693c8SChao YuDescription:	Show status of f2fs checkpoint in real time.
479718693c8SChao Yu
480718693c8SChao Yu		=============================== ==============================
481718693c8SChao Yu		cp flag				value
482718693c8SChao Yu		CP_UMOUNT_FLAG			0x00000001
483718693c8SChao Yu		CP_ORPHAN_PRESENT_FLAG		0x00000002
484718693c8SChao Yu		CP_COMPACT_SUM_FLAG		0x00000004
485718693c8SChao Yu		CP_ERROR_FLAG			0x00000008
486718693c8SChao Yu		CP_FSCK_FLAG			0x00000010
487718693c8SChao Yu		CP_FASTBOOT_FLAG		0x00000020
488718693c8SChao Yu		CP_CRC_RECOVERY_FLAG		0x00000040
489718693c8SChao Yu		CP_NAT_BITS_FLAG		0x00000080
490718693c8SChao Yu		CP_TRIMMED_FLAG			0x00000100
491718693c8SChao Yu		CP_NOCRC_RECOVERY_FLAG		0x00000200
492718693c8SChao Yu		CP_LARGE_NAT_BITMAP_FLAG	0x00000400
493718693c8SChao Yu		CP_QUOTA_NEED_FSCK_FLAG		0x00000800
494718693c8SChao Yu		CP_DISABLED_FLAG		0x00001000
495718693c8SChao Yu		CP_DISABLED_QUICK_FLAG		0x00002000
496718693c8SChao Yu		CP_RESIZEFS_FLAG		0x00004000
497718693c8SChao Yu		=============================== ==============================
498718693c8SChao Yu
499e6592066SDaeho JeongWhat:		/sys/fs/f2fs/<disk>/ckpt_thread_ioprio
500e6592066SDaeho JeongDate:		January 2021
501e6592066SDaeho JeongContact:	"Daeho Jeong" <daehojeong@google.com>
502e6592066SDaeho JeongDescription:	Give a way to change checkpoint merge daemon's io priority.
503e6592066SDaeho Jeong		Its default value is "be,3", which means "BE" I/O class and
504e6592066SDaeho Jeong		I/O priority "3". We can select the class between "rt" and "be",
505e6592066SDaeho Jeong		and set the I/O priority within valid range of it. "," delimiter
506e6592066SDaeho Jeong		is necessary in between I/O class and priority number.
50708234279SJaegeuk Kim
50808234279SJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/ovp_segments
50908234279SJaegeuk KimDate:		March 2021
51008234279SJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
51108234279SJaegeuk KimDescription:	Shows the number of overprovision segments.
5125ac443e2SDaeho Jeong
5135ac443e2SDaeho JeongWhat:		/sys/fs/f2fs/<disk>/compr_written_block
5145ac443e2SDaeho JeongDate:		March 2021
5155ac443e2SDaeho JeongContact:	"Daeho Jeong" <daehojeong@google.com>
5165ac443e2SDaeho JeongDescription:	Show the block count written after compression since mount. Note
5175ac443e2SDaeho Jeong		that when the compressed blocks are deleted, this count doesn't
5185ac443e2SDaeho Jeong		decrease. If you write "0" here, you can initialize
5195ac443e2SDaeho Jeong		compr_written_block and compr_saved_block to "0".
5205ac443e2SDaeho Jeong
5215ac443e2SDaeho JeongWhat:		/sys/fs/f2fs/<disk>/compr_saved_block
5225ac443e2SDaeho JeongDate:		March 2021
5235ac443e2SDaeho JeongContact:	"Daeho Jeong" <daehojeong@google.com>
5245ac443e2SDaeho JeongDescription:	Show the saved block count with compression since mount. Note
5255ac443e2SDaeho Jeong		that when the compressed blocks are deleted, this count doesn't
5265ac443e2SDaeho Jeong		decrease. If you write "0" here, you can initialize
5275ac443e2SDaeho Jeong		compr_written_block and compr_saved_block to "0".
5285ac443e2SDaeho Jeong
5295ac443e2SDaeho JeongWhat:		/sys/fs/f2fs/<disk>/compr_new_inode
5305ac443e2SDaeho JeongDate:		March 2021
5315ac443e2SDaeho JeongContact:	"Daeho Jeong" <daehojeong@google.com>
5325ac443e2SDaeho JeongDescription:	Show the count of inode newly enabled for compression since mount.
5335ac443e2SDaeho Jeong		Note that when the compression is disabled for the files, this count
5345ac443e2SDaeho Jeong		doesn't decrease. If you write "0" here, you can initialize
5355ac443e2SDaeho Jeong		compr_new_inode to "0".
5368939a848SChao Yu
5378939a848SChao YuWhat:		/sys/fs/f2fs/<disk>/atgc_candidate_ratio
5388939a848SChao YuDate:		May 2021
5398939a848SChao YuContact:	"Chao Yu" <yuchao0@huawei.com>
5408939a848SChao YuDescription:	When ATGC is on, it controls candidate ratio in order to limit total
5418939a848SChao Yu		number of potential victim in all candidates, the value should be in
5428939a848SChao Yu		range of [0, 100], by default it was initialized as 20(%).
5438939a848SChao Yu
5448939a848SChao YuWhat:		/sys/fs/f2fs/<disk>/atgc_candidate_count
5458939a848SChao YuDate:		May 2021
5468939a848SChao YuContact:	"Chao Yu" <yuchao0@huawei.com>
5478939a848SChao YuDescription:	When ATGC is on, it controls candidate count in order to limit total
5488939a848SChao Yu		number of potential victim in all candidates, by default it was
5498939a848SChao Yu		initialized as 10 (sections).
5508939a848SChao Yu
5518939a848SChao YuWhat:		/sys/fs/f2fs/<disk>/atgc_age_weight
5528939a848SChao YuDate:		May 2021
5538939a848SChao YuContact:	"Chao Yu" <yuchao0@huawei.com>
5548939a848SChao YuDescription:	When ATGC is on, it controls age weight to balance weight proportion
5558939a848SChao Yu		in between aging and valid blocks, the value should be in range of
5568939a848SChao Yu		[0, 100], by default it was initialized as 60(%).
5578939a848SChao Yu
5588939a848SChao YuWhat:		/sys/fs/f2fs/<disk>/atgc_age_threshold
5598939a848SChao YuDate:		May 2021
5608939a848SChao YuContact:	"Chao Yu" <yuchao0@huawei.com>
5618939a848SChao YuDescription:	When ATGC is on, it controls age threshold to bypass GCing young
5628939a848SChao Yu		candidates whose age is not beyond the threshold, by default it was
5638939a848SChao Yu		initialized as 604800 seconds (equals to 7 days).
56407c6b593SDaeho Jeong
56507c6b593SDaeho JeongWhat:		/sys/fs/f2fs/<disk>/gc_reclaimed_segments
56607c6b593SDaeho JeongDate:		July 2021
56707c6b593SDaeho JeongContact:	"Daeho Jeong" <daehojeong@google.com>
56807c6b593SDaeho JeongDescription:	Show how many segments have been reclaimed by GC during a specific
56907c6b593SDaeho Jeong		GC mode (0: GC normal, 1: GC idle CB, 2: GC idle greedy,
570d98af5f4SDaeho Jeong		3: GC idle AT, 4: GC urgent high, 5: GC urgent low 6: GC urgent mid)
57107c6b593SDaeho Jeong		You can re-initialize this value to "0".
57207c6b593SDaeho Jeong
57307c6b593SDaeho JeongWhat:		/sys/fs/f2fs/<disk>/gc_segment_mode
57407c6b593SDaeho JeongDate:		July 2021
57507c6b593SDaeho JeongContact:	"Daeho Jeong" <daehojeong@google.com>
57607c6b593SDaeho JeongDescription:	You can control for which gc mode the "gc_reclaimed_segments" node shows.
57707c6b593SDaeho Jeong		Refer to the description of the modes in "gc_reclaimed_segments".
5780f6b56ecSDaeho Jeong
5790f6b56ecSDaeho JeongWhat:		/sys/fs/f2fs/<disk>/seq_file_ra_mul
5800f6b56ecSDaeho JeongDate:		July 2021
5810f6b56ecSDaeho JeongContact:	"Daeho Jeong" <daehojeong@google.com>
5820f6b56ecSDaeho JeongDescription:	You can	control the multiplier value of	bdi device readahead window size
5830f6b56ecSDaeho Jeong		between 2 (default) and 256 for POSIX_FADV_SEQUENTIAL advise option.
5846691d940SDaeho Jeong
5856691d940SDaeho JeongWhat:		/sys/fs/f2fs/<disk>/max_fragment_chunk
5866691d940SDaeho JeongDate:		August 2021
5876691d940SDaeho JeongContact:	"Daeho Jeong" <daehojeong@google.com>
5886691d940SDaeho JeongDescription:	With "mode=fragment:block" mount options, we can scatter block allocation.
5896691d940SDaeho Jeong		f2fs will allocate 1..<max_fragment_chunk> blocks in a chunk and make a hole
5906691d940SDaeho Jeong		in the length of 1..<max_fragment_hole> by turns. This value can be set
5916691d940SDaeho Jeong		between 1..512 and the default value is 4.
5926691d940SDaeho Jeong
5936691d940SDaeho JeongWhat:		/sys/fs/f2fs/<disk>/max_fragment_hole
5946691d940SDaeho JeongDate:		August 2021
5956691d940SDaeho JeongContact:	"Daeho Jeong" <daehojeong@google.com>
5966691d940SDaeho JeongDescription:	With "mode=fragment:block" mount options, we can scatter block allocation.
5976691d940SDaeho Jeong		f2fs will allocate 1..<max_fragment_chunk> blocks in a chunk and make a hole
5986691d940SDaeho Jeong		in the length of 1..<max_fragment_hole> by turns. This value can be set
5996691d940SDaeho Jeong		between 1..512 and the default value is 4.
600325163e9SDaeho Jeong
601325163e9SDaeho JeongWhat:		/sys/fs/f2fs/<disk>/gc_urgent_high_remaining
602325163e9SDaeho JeongDate:		December 2021
603325163e9SDaeho JeongContact:	"Daeho Jeong" <daehojeong@google.com>
604325163e9SDaeho JeongDescription:	You can set the trial count limit for GC urgent high mode with this value.
605325163e9SDaeho Jeong		If GC thread gets to the limit, the mode will turn back to GC normal mode.
606325163e9SDaeho Jeong		By default, the value is zero, which means there is no limit like before.
60747c8ebccSJaegeuk Kim
60847c8ebccSJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/max_roll_forward_node_blocks
60947c8ebccSJaegeuk KimDate:		January 2022
61047c8ebccSJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
61147c8ebccSJaegeuk KimDescription:	Controls max # of node block writes to be used for roll forward
61247c8ebccSJaegeuk Kim		recovery. This can limit the roll forward recovery time.
6138e0f54a7SJaegeuk Kim
6148e0f54a7SJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/unusable_blocks_per_sec
6158e0f54a7SJaegeuk KimDate:		June 2022
6168e0f54a7SJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
6178e0f54a7SJaegeuk KimDescription:	Shows the number of unusable blocks in a section which was defined by
6188e0f54a7SJaegeuk Kim		the zone capacity reported by underlying zoned device.
619f8e2f32bSDaeho Jeong
620f8e2f32bSDaeho JeongWhat:		/sys/fs/f2fs/<disk>/current_atomic_write
621f8e2f32bSDaeho JeongDate:		July 2022
622f8e2f32bSDaeho JeongContact:	"Daeho Jeong" <daehojeong@google.com>
623f8e2f32bSDaeho JeongDescription:	Show the total current atomic write block count, which is not committed yet.
624f8e2f32bSDaeho Jeong		This is a read-only entry.
625f8e2f32bSDaeho Jeong
626f8e2f32bSDaeho JeongWhat:		/sys/fs/f2fs/<disk>/peak_atomic_write
627f8e2f32bSDaeho JeongDate:		July 2022
628f8e2f32bSDaeho JeongContact:	"Daeho Jeong" <daehojeong@google.com>
629f8e2f32bSDaeho JeongDescription:	Show the peak value of total current atomic write block count after boot.
630f8e2f32bSDaeho Jeong		If you write "0" here, you can initialize to "0".
631f8e2f32bSDaeho Jeong
632f8e2f32bSDaeho JeongWhat:		/sys/fs/f2fs/<disk>/committed_atomic_block
633f8e2f32bSDaeho JeongDate:		July 2022
634f8e2f32bSDaeho JeongContact:	"Daeho Jeong" <daehojeong@google.com>
635f8e2f32bSDaeho JeongDescription:	Show the accumulated total committed atomic write block count after boot.
636f8e2f32bSDaeho Jeong		If you write "0" here, you can initialize to "0".
637f8e2f32bSDaeho Jeong
638f8e2f32bSDaeho JeongWhat:		/sys/fs/f2fs/<disk>/revoked_atomic_block
639f8e2f32bSDaeho JeongDate:		July 2022
640f8e2f32bSDaeho JeongContact:	"Daeho Jeong" <daehojeong@google.com>
641f8e2f32bSDaeho JeongDescription:	Show the accumulated total revoked atomic write block count after boot.
642f8e2f32bSDaeho Jeong		If you write "0" here, you can initialize to "0".
643a3951cd1SYangtao Li
644a3951cd1SYangtao LiWhat:		/sys/fs/f2fs/<disk>/gc_mode
645a3951cd1SYangtao LiDate:		October 2022
646a3951cd1SYangtao LiContact:	"Yangtao Li" <frank.li@vivo.com>
647a3951cd1SYangtao LiDescription:	Show the current gc_mode as a string.
648a3951cd1SYangtao Li		This is a read-only entry.
649