xref: /linux/Documentation/ABI/testing/sysfs-fs-f2fs (revision 8e0f54a70e9b0c88d6375933d281d631b7248153)
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
102b2e4a2b3SKonstantin VyshetskyWhat:		/sys/fs/f2fs/<disk>/max_discard_request
103b2e4a2b3SKonstantin VyshetskyDate:		December 2021
104b2e4a2b3SKonstantin VyshetskyContact:	"Konstantin Vyshetsky" <vkon@google.com>
105b2e4a2b3SKonstantin VyshetskyDescription:	Controls the number of discards a thread will issue at a time.
106b2e4a2b3SKonstantin Vyshetsky		Higher number will allow the discard thread to finish its work
107b2e4a2b3SKonstantin Vyshetsky		faster, at the cost of higher latency for incomming I/O.
108b2e4a2b3SKonstantin Vyshetsky
109b2e4a2b3SKonstantin VyshetskyWhat:		/sys/fs/f2fs/<disk>/min_discard_issue_time
110b2e4a2b3SKonstantin VyshetskyDate:		December 2021
111b2e4a2b3SKonstantin VyshetskyContact:	"Konstantin Vyshetsky" <vkon@google.com>
112b2e4a2b3SKonstantin VyshetskyDescription:	Controls the interval the discard thread will wait between
113b2e4a2b3SKonstantin Vyshetsky		issuing discard requests when there are discards to be issued and
114b2e4a2b3SKonstantin Vyshetsky		no I/O aware interruptions occur.
115b2e4a2b3SKonstantin Vyshetsky
116b2e4a2b3SKonstantin VyshetskyWhat:		/sys/fs/f2fs/<disk>/mid_discard_issue_time
117b2e4a2b3SKonstantin VyshetskyDate:		December 2021
118b2e4a2b3SKonstantin VyshetskyContact:	"Konstantin Vyshetsky" <vkon@google.com>
119b2e4a2b3SKonstantin VyshetskyDescription:	Controls the interval the discard thread will wait between
120b2e4a2b3SKonstantin Vyshetsky		issuing discard requests when there are discards to be issued and
121b2e4a2b3SKonstantin Vyshetsky		an I/O aware interruption occurs.
122b2e4a2b3SKonstantin Vyshetsky
123b2e4a2b3SKonstantin VyshetskyWhat:		/sys/fs/f2fs/<disk>/max_discard_issue_time
124b2e4a2b3SKonstantin VyshetskyDate:		December 2021
125b2e4a2b3SKonstantin VyshetskyContact:	"Konstantin Vyshetsky" <vkon@google.com>
126b2e4a2b3SKonstantin VyshetskyDescription:	Controls the interval the discard thread will wait when there are
127b2e4a2b3SKonstantin Vyshetsky		no discard operations to be issued.
128b2e4a2b3SKonstantin Vyshetsky
129969d1b18SChao YuWhat:		/sys/fs/f2fs/<disk>/discard_granularity
130969d1b18SChao YuDate:		July 2017
131969d1b18SChao YuContact:	"Chao Yu" <yuchao0@huawei.com>
132f5fa7c8bSHridya ValsarajuDescription:	Controls discard granularity of inner discard thread. Inner thread
133969d1b18SChao Yu		will not issue discards with size that is smaller than granularity.
134f5fa7c8bSHridya Valsaraju		The unit size is one block(4KB), now only support configuring
135f5fa7c8bSHridya Valsaraju		in range of [1, 512]. Default value is 4(=16KB).
136969d1b18SChao Yu
13703f2c02dSJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/umount_discard_timeout
13803f2c02dSJaegeuk KimDate:		January 2019
13903f2c02dSJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
140f5fa7c8bSHridya ValsarajuDescription:	Set timeout to issue discard commands during umount.
14103f2c02dSJaegeuk Kim	        Default: 5 secs
14203f2c02dSJaegeuk Kim
143ae2e2804SJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/pending_discard
144ae2e2804SJaegeuk KimDate:		November 2021
145ae2e2804SJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
146ae2e2804SJaegeuk KimDescription:	Shows the number of pending discard commands in the queue.
147ae2e2804SJaegeuk Kim
1483bac380cSJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/max_victim_search
1493bac380cSJaegeuk KimDate:		January 2014
1503bac380cSJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk.kim@samsung.com>
151f5fa7c8bSHridya ValsarajuDescription:	Controls the number of trials to find a victim segment
152f5fa7c8bSHridya Valsaraju		when conducting SSR and cleaning operations. The default value
153f5fa7c8bSHridya Valsaraju		is 4096 which covers 8GB block address range.
154cdfc41c1SJaegeuk Kim
15534655575SChao YuWhat:		/sys/fs/f2fs/<disk>/migration_granularity
15634655575SChao YuDate:		October 2018
15734655575SChao YuContact:	"Chao Yu" <yuchao0@huawei.com>
158f5fa7c8bSHridya ValsarajuDescription:	Controls migration granularity of garbage collection on large
15934655575SChao Yu		section, it can let GC move partial segment{s} of one section
16034655575SChao Yu		in one GC cycle, so that dispersing heavy overhead GC to
16134655575SChao Yu		multiple lightweight one.
16234655575SChao Yu
16391796825SJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/dir_level
16491796825SJaegeuk KimDate:		March 2014
16591796825SJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk.kim@samsung.com>
166f5fa7c8bSHridya ValsarajuDescription:	Controls the directory level for large directory. If a
167f5fa7c8bSHridya Valsaraju		directory has a number of files, it can reduce the file lookup
168f5fa7c8bSHridya Valsaraju		latency by increasing this dir_level value. Otherwise, it
169f5fa7c8bSHridya Valsaraju		needs to decrease this value to reduce the space overhead.
170f5fa7c8bSHridya Valsaraju		The default value is 0.
17191796825SJaegeuk Kim
172cdfc41c1SJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/ram_thresh
173cdfc41c1SJaegeuk KimDate:		March 2014
174cdfc41c1SJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk.kim@samsung.com>
175f5fa7c8bSHridya ValsarajuDescription:	Controls the memory footprint used by free nids and cached
176f5fa7c8bSHridya Valsaraju		nat entries. By default, 1 is set, which indicates
177f5fa7c8bSHridya Valsaraju		10 MB / 1 GB RAM.
178bba681cbSJaegeuk Kim
1796f6d9fe2SChao YuWhat:		/sys/fs/f2fs/<disk>/batched_trim_sections
180bba681cbSJaegeuk KimDate:		February 2015
181bba681cbSJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
182f5fa7c8bSHridya ValsarajuDescription:	Controls the trimming rate in batch mode.
183377224c4SChao Yu		<deprecated>
18460b99b48SJaegeuk Kim
18560b99b48SJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/cp_interval
18660b99b48SJaegeuk KimDate:		October 2015
18760b99b48SJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
188f5fa7c8bSHridya ValsarajuDescription:	Controls the checkpoint timing, set to 60 seconds by default.
189ea1a29a0SChao Yu
190d0239e1bSJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/idle_interval
191d0239e1bSJaegeuk KimDate:		January 2016
192d0239e1bSJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
193f5fa7c8bSHridya ValsarajuDescription:	Controls the idle timing of system, if there is no FS operation
194f5fa7c8bSHridya Valsaraju		during given interval.
195f5fa7c8bSHridya Valsaraju		Set to 5 seconds by default.
196a7d10cf3SSahitya Tummala
197a7d10cf3SSahitya TummalaWhat:		/sys/fs/f2fs/<disk>/discard_idle_interval
198a7d10cf3SSahitya TummalaDate:		September 2018
199a7d10cf3SSahitya TummalaContact:	"Chao Yu" <yuchao0@huawei.com>
200a7d10cf3SSahitya TummalaContact:	"Sahitya Tummala" <stummala@codeaurora.org>
201f5fa7c8bSHridya ValsarajuDescription:	Controls the idle timing of discard thread given
202f5fa7c8bSHridya Valsaraju		this time interval.
203f5fa7c8bSHridya Valsaraju		Default is 5 secs.
204a7d10cf3SSahitya Tummala
205a7d10cf3SSahitya TummalaWhat:		/sys/fs/f2fs/<disk>/gc_idle_interval
206a7d10cf3SSahitya TummalaDate:		September 2018
207a7d10cf3SSahitya TummalaContact:	"Chao Yu" <yuchao0@huawei.com>
208a7d10cf3SSahitya TummalaContact:	"Sahitya Tummala" <stummala@codeaurora.org>
209f5fa7c8bSHridya ValsarajuDescription:    Controls the idle timing for gc path. Set to 5 seconds by default.
210d0239e1bSJaegeuk Kim
211b32d73abSChao YuWhat:		/sys/fs/f2fs/<disk>/iostat_enable
212b32d73abSChao YuDate:		August 2017
213b32d73abSChao YuContact:	"Chao Yu" <yuchao0@huawei.com>
214f5fa7c8bSHridya ValsarajuDescription:	Controls to enable/disable IO stat.
215b32d73abSChao Yu
216ea1a29a0SChao YuWhat:		/sys/fs/f2fs/<disk>/ra_nid_pages
217ea1a29a0SChao YuDate:		October 2015
218ea1a29a0SChao YuContact:	"Chao Yu" <chao2.yu@samsung.com>
219f5fa7c8bSHridya ValsarajuDescription:	Controls the count of nid pages to be readaheaded.
220f5fa7c8bSHridya Valsaraju		When building free nids, F2FS reads NAT blocks ahead for
221f5fa7c8bSHridya Valsaraju		speed up. Default is 0.
2222304cb0cSChao Yu
2232304cb0cSChao YuWhat:		/sys/fs/f2fs/<disk>/dirty_nats_ratio
2242304cb0cSChao YuDate:		January 2016
2252304cb0cSChao YuContact:	"Chao Yu" <chao2.yu@samsung.com>
226f5fa7c8bSHridya ValsarajuDescription:	Controls dirty nat entries ratio threshold, if current
2272304cb0cSChao Yu		ratio exceeds configured threshold, checkpoint will
2282304cb0cSChao Yu		be triggered for flushing dirty nat entries.
2298f1dbbbbSShuoran Liu
2308f1dbbbbSShuoran LiuWhat:		/sys/fs/f2fs/<disk>/lifetime_write_kbytes
2318f1dbbbbSShuoran LiuDate:		January 2016
2328f1dbbbbSShuoran LiuContact:	"Shuoran Liu" <liushuoran@huawei.com>
233f5fa7c8bSHridya ValsarajuDescription:	Shows total written kbytes issued to disk.
23456412894SChao Yu
2359ac19faaSEric BiggersWhat:		/sys/fs/f2fs/<disk>/features
236b32d73abSChao YuDate:		July 2017
237b32d73abSChao YuContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
2384c89b53dSJaegeuk KimDescription:	<deprecated: should use /sys/fs/f2fs/<disk>/feature_list/
2394c89b53dSJaegeuk Kim		Shows all enabled features in current device.
2404c89b53dSJaegeuk Kim		Supported features:
2414c89b53dSJaegeuk Kim		encryption, blkzoned, extra_attr, projquota, inode_checksum,
2424c89b53dSJaegeuk Kim		flexible_inline_xattr, quota_ino, inode_crtime, lost_found,
2434c89b53dSJaegeuk Kim		verity, sb_checksum, casefold, readonly, compression, pin_file.
2444c89b53dSJaegeuk Kim
2454c89b53dSJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/feature_list/
2464c89b53dSJaegeuk KimDate:		June 2021
2474c89b53dSJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
2484c89b53dSJaegeuk KimDescription:	Expand /sys/fs/f2fs/<disk>/features to meet sysfs rule.
2494c89b53dSJaegeuk Kim		Supported on-disk features:
2504c89b53dSJaegeuk Kim		encryption, block_zoned (aka blkzoned), extra_attr,
2514c89b53dSJaegeuk Kim		project_quota (aka projquota), inode_checksum,
2524c89b53dSJaegeuk Kim		flexible_inline_xattr, quota_ino, inode_crtime, lost_found,
2534c89b53dSJaegeuk Kim		verity, sb_checksum, casefold, readonly, compression.
2544c89b53dSJaegeuk Kim		Note that, pin_file is moved into /sys/fs/f2fs/features/.
2554c89b53dSJaegeuk Kim
2564c89b53dSJaegeuk KimWhat:		/sys/fs/f2fs/features/
2574c89b53dSJaegeuk KimDate:		July 2017
2584c89b53dSJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
2594c89b53dSJaegeuk KimDescription:	Shows all enabled kernel features.
2604c89b53dSJaegeuk Kim		Supported features:
2614c89b53dSJaegeuk Kim		encryption, block_zoned, extra_attr, project_quota,
2624c89b53dSJaegeuk Kim		inode_checksum, flexible_inline_xattr, quota_ino,
2634c89b53dSJaegeuk Kim		inode_crtime, lost_found, verity, sb_checksum,
2644c89b53dSJaegeuk Kim		casefold, readonly, compression, test_dummy_encryption_v2,
2654c89b53dSJaegeuk Kim		atomic_write, pin_file, encrypted_casefold.
266b32d73abSChao Yu
26756412894SChao YuWhat:		/sys/fs/f2fs/<disk>/inject_rate
26856412894SChao YuDate:		May 2016
26956412894SChao YuContact:	"Sheng Yong" <shengyong1@huawei.com>
270f5fa7c8bSHridya ValsarajuDescription:	Controls the injection rate of arbitrary faults.
27156412894SChao Yu
27256412894SChao YuWhat:		/sys/fs/f2fs/<disk>/inject_type
27356412894SChao YuDate:		May 2016
27456412894SChao YuContact:	"Sheng Yong" <shengyong1@huawei.com>
275f5fa7c8bSHridya ValsarajuDescription:	Controls the injection type of arbitrary faults.
276f5fa7c8bSHridya Valsaraju
277f5fa7c8bSHridya ValsarajuWhat:		/sys/fs/f2fs/<disk>/dirty_segments
278f5fa7c8bSHridya ValsarajuDate:		October 2017
279f5fa7c8bSHridya ValsarajuContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
280f5fa7c8bSHridya ValsarajuDescription:	Shows the number of dirty segments.
281daeb433eSChao Yu
282daeb433eSChao YuWhat:		/sys/fs/f2fs/<disk>/reserved_blocks
283daeb433eSChao YuDate:		June 2017
284daeb433eSChao YuContact:	"Chao Yu" <yuchao0@huawei.com>
285f5fa7c8bSHridya ValsarajuDescription:	Controls target reserved blocks in system, the threshold
28680d42145SYunlong Song		is soft, it could exceed current available user space.
28780d42145SYunlong Song
28880d42145SYunlong SongWhat:		/sys/fs/f2fs/<disk>/current_reserved_blocks
28980d42145SYunlong SongDate:		October 2017
29080d42145SYunlong SongContact:	"Yunlong Song" <yunlong.song@huawei.com>
29180d42145SYunlong SongContact:	"Chao Yu" <yuchao0@huawei.com>
292f5fa7c8bSHridya ValsarajuDescription:	Shows current reserved blocks in system, it may be temporarily
29380d42145SYunlong Song		smaller than target_reserved_blocks, but will gradually
29480d42145SYunlong Song		increase to target_reserved_blocks when more free blocks are
29580d42145SYunlong Song		freed by user later.
296d9872a69SJaegeuk Kim
297d9872a69SJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/gc_urgent
298d9872a69SJaegeuk KimDate:		August 2017
299d9872a69SJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
300d98af5f4SDaeho JeongDescription:	Do background GC aggressively when set. Set to 0 by default.
301d98af5f4SDaeho Jeong		gc urgent high(1): does GC forcibly in a period of given
302d98af5f4SDaeho Jeong		gc_urgent_sleep_time and ignores I/O idling check. uses greedy
303d98af5f4SDaeho Jeong		GC approach and turns SSR mode on.
304d98af5f4SDaeho Jeong		gc urgent low(2): lowers the bar of checking I/O idling in
305d98af5f4SDaeho Jeong		order to process outstanding discard commands and GC a
306d98af5f4SDaeho Jeong		little bit aggressively. uses cost benefit GC approach.
307d98af5f4SDaeho Jeong		gc urgent mid(3): does GC forcibly in a period of given
308d98af5f4SDaeho Jeong		gc_urgent_sleep_time and executes a mid level of I/O idling check.
309d98af5f4SDaeho Jeong		uses cost benefit GC approach.
310d9872a69SJaegeuk Kim
311d9872a69SJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/gc_urgent_sleep_time
312d9872a69SJaegeuk KimDate:		August 2017
313d9872a69SJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
314f5fa7c8bSHridya ValsarajuDescription:	Controls sleep time of GC urgent mode. Set to 500ms by default.
315f6df8f23SSheng Yong
316f6df8f23SSheng YongWhat:		/sys/fs/f2fs/<disk>/readdir_ra
317f6df8f23SSheng YongDate:		November 2017
318f6df8f23SSheng YongContact:	"Sheng Yong" <shengyong1@huawei.com>
319f5fa7c8bSHridya ValsarajuDescription:	Controls readahead inode block in readdir. Enabled by default.
320f5fa7c8bSHridya Valsaraju
321f5fa7c8bSHridya ValsarajuWhat:		/sys/fs/f2fs/<disk>/gc_pin_file_thresh
322f5fa7c8bSHridya ValsarajuDate:		January 2018
323f5fa7c8bSHridya ValsarajuContact:	Jaegeuk Kim <jaegeuk@kernel.org>
324f5fa7c8bSHridya ValsarajuDescription:	This indicates how many GC can be failed for the pinned
325f5fa7c8bSHridya Valsaraju		file. If it exceeds this, F2FS doesn't guarantee its pinning
326f5fa7c8bSHridya Valsaraju		state. 2048 trials is set by default.
327846ae671SChao Yu
328846ae671SChao YuWhat:		/sys/fs/f2fs/<disk>/extension_list
329846ae671SChao YuDate:		Feburary 2018
330846ae671SChao YuContact:	"Chao Yu" <yuchao0@huawei.com>
331f5fa7c8bSHridya ValsarajuDescription:	Used to control configure extension list:
332846ae671SChao Yu		- Query: cat /sys/fs/f2fs/<disk>/extension_list
333b6a06cbbSChao Yu		- Add: echo '[h/c]extension' > /sys/fs/f2fs/<disk>/extension_list
334b6a06cbbSChao Yu		- Del: echo '[h/c]!extension' > /sys/fs/f2fs/<disk>/extension_list
335b6a06cbbSChao Yu		- [h] means add/del hot file extension
336b6a06cbbSChao Yu		- [c] means add/del cold file extension
3374d3aed70SDaniel Rosenberg
3384d3aed70SDaniel RosenbergWhat:		/sys/fs/f2fs/<disk>/unusable
3394d3aed70SDaniel RosenbergDate		April 2019
3404d3aed70SDaniel RosenbergContact:	"Daniel Rosenberg" <drosen@google.com>
341f5fa7c8bSHridya ValsarajuDescription:	If checkpoint=disable, it displays the number of blocks that
342f5fa7c8bSHridya Valsaraju		are unusable.
343c67c8c0fSxuyehan		If checkpoint=enable it displays the number of blocks that
344f5fa7c8bSHridya Valsaraju		would be unusable if checkpoint=disable were to be set.
3455aba5430SDaniel Rosenberg
3465aba5430SDaniel RosenbergWhat:		/sys/fs/f2fs/<disk>/encoding
3475aba5430SDaniel RosenbergDate		July 2019
3485aba5430SDaniel RosenbergContact:	"Daniel Rosenberg" <drosen@google.com>
349f5fa7c8bSHridya ValsarajuDescription:	Displays name and version of the encoding set for the filesystem.
3505aba5430SDaniel Rosenberg		If no encoding is set, displays (none)
351fc7100eaSHridya Valsaraju
352fc7100eaSHridya ValsarajuWhat:		/sys/fs/f2fs/<disk>/free_segments
353fc7100eaSHridya ValsarajuDate:		September 2019
354fc7100eaSHridya ValsarajuContact:	"Hridya Valsaraju" <hridya@google.com>
355fc7100eaSHridya ValsarajuDescription:	Number of free segments in disk.
356fc7100eaSHridya Valsaraju
357fc7100eaSHridya ValsarajuWhat:		/sys/fs/f2fs/<disk>/cp_foreground_calls
358fc7100eaSHridya ValsarajuDate:		September 2019
359fc7100eaSHridya ValsarajuContact:	"Hridya Valsaraju" <hridya@google.com>
360fc7100eaSHridya ValsarajuDescription:	Number of checkpoint operations performed on demand. Available when
361fc7100eaSHridya Valsaraju		CONFIG_F2FS_STAT_FS=y.
362fc7100eaSHridya Valsaraju
363fc7100eaSHridya ValsarajuWhat:		/sys/fs/f2fs/<disk>/cp_background_calls
364fc7100eaSHridya ValsarajuDate:		September 2019
365fc7100eaSHridya ValsarajuContact:	"Hridya Valsaraju" <hridya@google.com>
366fc7100eaSHridya ValsarajuDescription:	Number of checkpoint operations performed in the background to
367fc7100eaSHridya Valsaraju		free segments. Available when CONFIG_F2FS_STAT_FS=y.
368fc7100eaSHridya Valsaraju
369fc7100eaSHridya ValsarajuWhat:		/sys/fs/f2fs/<disk>/gc_foreground_calls
370fc7100eaSHridya ValsarajuDate:		September 2019
371fc7100eaSHridya ValsarajuContact:	"Hridya Valsaraju" <hridya@google.com>
372fc7100eaSHridya ValsarajuDescription:	Number of garbage collection operations performed on demand.
373fc7100eaSHridya Valsaraju		Available when CONFIG_F2FS_STAT_FS=y.
374fc7100eaSHridya Valsaraju
375fc7100eaSHridya ValsarajuWhat:		/sys/fs/f2fs/<disk>/gc_background_calls
376fc7100eaSHridya ValsarajuDate:		September 2019
377fc7100eaSHridya ValsarajuContact:	"Hridya Valsaraju" <hridya@google.com>
378fc7100eaSHridya ValsarajuDescription:	Number of garbage collection operations triggered in background.
379fc7100eaSHridya Valsaraju		Available when CONFIG_F2FS_STAT_FS=y.
380fc7100eaSHridya Valsaraju
381fc7100eaSHridya ValsarajuWhat:		/sys/fs/f2fs/<disk>/moved_blocks_foreground
382fc7100eaSHridya ValsarajuDate:		September 2019
383fc7100eaSHridya ValsarajuContact:	"Hridya Valsaraju" <hridya@google.com>
384fc7100eaSHridya ValsarajuDescription:	Number of blocks moved by garbage collection in foreground.
385fc7100eaSHridya Valsaraju		Available when CONFIG_F2FS_STAT_FS=y.
386fc7100eaSHridya Valsaraju
387fc7100eaSHridya ValsarajuWhat:		/sys/fs/f2fs/<disk>/moved_blocks_background
388fc7100eaSHridya ValsarajuDate:		September 2019
389fc7100eaSHridya ValsarajuContact:	"Hridya Valsaraju" <hridya@google.com>
390fc7100eaSHridya ValsarajuDescription:	Number of blocks moved by garbage collection in background.
391fc7100eaSHridya Valsaraju		Available when CONFIG_F2FS_STAT_FS=y.
392fc7100eaSHridya Valsaraju
393fc7100eaSHridya ValsarajuWhat:		/sys/fs/f2fs/<disk>/avg_vblocks
394fc7100eaSHridya ValsarajuDate:		September 2019
395fc7100eaSHridya ValsarajuContact:	"Hridya Valsaraju" <hridya@google.com>
396fc7100eaSHridya ValsarajuDescription:	Average number of valid blocks.
397fc7100eaSHridya Valsaraju		Available when CONFIG_F2FS_STAT_FS=y.
398a7e679b5SJaegeuk Kim
399a7e679b5SJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/mounted_time_sec
400a7e679b5SJaegeuk KimDate:		February 2020
401a7e679b5SJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
402a7e679b5SJaegeuk KimDescription:	Show the mounted time in secs of this partition.
403da9953b7SJaegeuk Kim
404da9953b7SJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/data_io_flag
405da9953b7SJaegeuk KimDate:		April 2020
406da9953b7SJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
407da9953b7SJaegeuk KimDescription:	Give a way to attach REQ_META|FUA to data writes
408da9953b7SJaegeuk Kim		given temperature-based bits. Now the bits indicate:
40954a19b4dSMauro Carvalho Chehab
41054a19b4dSMauro Carvalho Chehab		+-------------------+-------------------+
41154a19b4dSMauro Carvalho Chehab		|      REQ_META     |      REQ_FUA      |
41254a19b4dSMauro Carvalho Chehab		+------+------+-----+------+------+-----+
41354a19b4dSMauro Carvalho Chehab		|    5 |    4 |   3 |    2 |    1 |   0 |
41454a19b4dSMauro Carvalho Chehab		+------+------+-----+------+------+-----+
41554a19b4dSMauro Carvalho Chehab		| Cold | Warm | Hot | Cold | Warm | Hot |
41654a19b4dSMauro Carvalho Chehab		+------+------+-----+------+------+-----+
4172bc4bea3SDaeho Jeong
41832b6aba8SJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/node_io_flag
41932b6aba8SJaegeuk KimDate:		June 2020
42032b6aba8SJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
42132b6aba8SJaegeuk KimDescription:	Give a way to attach REQ_META|FUA to node writes
42232b6aba8SJaegeuk Kim		given temperature-based bits. Now the bits indicate:
42354a19b4dSMauro Carvalho Chehab
42454a19b4dSMauro Carvalho Chehab		+-------------------+-------------------+
42554a19b4dSMauro Carvalho Chehab		|      REQ_META     |      REQ_FUA      |
42654a19b4dSMauro Carvalho Chehab		+------+------+-----+------+------+-----+
42754a19b4dSMauro Carvalho Chehab		|    5 |    4 |   3 |    2 |    1 |   0 |
42854a19b4dSMauro Carvalho Chehab		+------+------+-----+------+------+-----+
42954a19b4dSMauro Carvalho Chehab		| Cold | Warm | Hot | Cold | Warm | Hot |
43054a19b4dSMauro Carvalho Chehab		+------+------+-----+------+------+-----+
43132b6aba8SJaegeuk Kim
4322bc4bea3SDaeho JeongWhat:		/sys/fs/f2fs/<disk>/iostat_period_ms
4332bc4bea3SDaeho JeongDate:		April 2020
4342bc4bea3SDaeho JeongContact:	"Daeho Jeong" <daehojeong@google.com>
4352bc4bea3SDaeho JeongDescription:	Give a way to change iostat_period time. 3secs by default.
4362bc4bea3SDaeho Jeong		The new iostat trace gives stats gap given the period.
43710208567SJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/max_io_bytes
43810208567SJaegeuk KimDate:		December 2020
43910208567SJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
44010208567SJaegeuk KimDescription:	This gives a control to limit the bio size in f2fs.
44110208567SJaegeuk Kim		Default is zero, which will follow underlying block layer limit,
44210208567SJaegeuk Kim		whereas, if it has a certain bytes value, f2fs won't submit a
44310208567SJaegeuk Kim		bio larger than that size.
4440bfe9f79SChao Yu
4450bfe9f79SChao YuWhat:		/sys/fs/f2fs/<disk>/stat/sb_status
4460bfe9f79SChao YuDate:		December 2020
4470bfe9f79SChao YuContact:	"Chao Yu" <yuchao0@huawei.com>
4480bfe9f79SChao YuDescription:	Show status of f2fs superblock in real time.
4490bfe9f79SChao Yu
4500bfe9f79SChao Yu		====== ===================== =================================
4510bfe9f79SChao Yu		value  sb status macro       description
4520bfe9f79SChao Yu		0x1    SBI_IS_DIRTY          dirty flag for checkpoint
4530bfe9f79SChao Yu		0x2    SBI_IS_CLOSE          specify unmounting
4540bfe9f79SChao Yu		0x4    SBI_NEED_FSCK         need fsck.f2fs to fix
4550bfe9f79SChao Yu		0x8    SBI_POR_DOING         recovery is doing or not
4560bfe9f79SChao Yu		0x10   SBI_NEED_SB_WRITE     need to recover superblock
4570bfe9f79SChao Yu		0x20   SBI_NEED_CP           need to checkpoint
4580bfe9f79SChao Yu		0x40   SBI_IS_SHUTDOWN       shutdown by ioctl
4590bfe9f79SChao Yu		0x80   SBI_IS_RECOVERED      recovered orphan/data
4600bfe9f79SChao Yu		0x100  SBI_CP_DISABLED       CP was disabled last mount
4610bfe9f79SChao Yu		0x200  SBI_CP_DISABLED_QUICK CP was disabled quickly
4620bfe9f79SChao Yu		0x400  SBI_QUOTA_NEED_FLUSH  need to flush quota info in CP
4630bfe9f79SChao Yu		0x800  SBI_QUOTA_SKIP_FLUSH  skip flushing quota in current CP
4640bfe9f79SChao Yu		0x1000 SBI_QUOTA_NEED_REPAIR quota file may be corrupted
4650bfe9f79SChao Yu		0x2000 SBI_IS_RESIZEFS       resizefs is in process
466ba900534SJaegeuk Kim		0x4000 SBI_IS_FREEZING       freefs is in process
4670bfe9f79SChao Yu		====== ===================== =================================
468e6592066SDaeho Jeong
469e6592066SDaeho JeongWhat:		/sys/fs/f2fs/<disk>/ckpt_thread_ioprio
470e6592066SDaeho JeongDate:		January 2021
471e6592066SDaeho JeongContact:	"Daeho Jeong" <daehojeong@google.com>
472e6592066SDaeho JeongDescription:	Give a way to change checkpoint merge daemon's io priority.
473e6592066SDaeho Jeong		Its default value is "be,3", which means "BE" I/O class and
474e6592066SDaeho Jeong		I/O priority "3". We can select the class between "rt" and "be",
475e6592066SDaeho Jeong		and set the I/O priority within valid range of it. "," delimiter
476e6592066SDaeho Jeong		is necessary in between I/O class and priority number.
47708234279SJaegeuk Kim
47808234279SJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/ovp_segments
47908234279SJaegeuk KimDate:		March 2021
48008234279SJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
48108234279SJaegeuk KimDescription:	Shows the number of overprovision segments.
4825ac443e2SDaeho Jeong
4835ac443e2SDaeho JeongWhat:		/sys/fs/f2fs/<disk>/compr_written_block
4845ac443e2SDaeho JeongDate:		March 2021
4855ac443e2SDaeho JeongContact:	"Daeho Jeong" <daehojeong@google.com>
4865ac443e2SDaeho JeongDescription:	Show the block count written after compression since mount. Note
4875ac443e2SDaeho Jeong		that when the compressed blocks are deleted, this count doesn't
4885ac443e2SDaeho Jeong		decrease. If you write "0" here, you can initialize
4895ac443e2SDaeho Jeong		compr_written_block and compr_saved_block to "0".
4905ac443e2SDaeho Jeong
4915ac443e2SDaeho JeongWhat:		/sys/fs/f2fs/<disk>/compr_saved_block
4925ac443e2SDaeho JeongDate:		March 2021
4935ac443e2SDaeho JeongContact:	"Daeho Jeong" <daehojeong@google.com>
4945ac443e2SDaeho JeongDescription:	Show the saved block count with compression since mount. Note
4955ac443e2SDaeho Jeong		that when the compressed blocks are deleted, this count doesn't
4965ac443e2SDaeho Jeong		decrease. If you write "0" here, you can initialize
4975ac443e2SDaeho Jeong		compr_written_block and compr_saved_block to "0".
4985ac443e2SDaeho Jeong
4995ac443e2SDaeho JeongWhat:		/sys/fs/f2fs/<disk>/compr_new_inode
5005ac443e2SDaeho JeongDate:		March 2021
5015ac443e2SDaeho JeongContact:	"Daeho Jeong" <daehojeong@google.com>
5025ac443e2SDaeho JeongDescription:	Show the count of inode newly enabled for compression since mount.
5035ac443e2SDaeho Jeong		Note that when the compression is disabled for the files, this count
5045ac443e2SDaeho Jeong		doesn't decrease. If you write "0" here, you can initialize
5055ac443e2SDaeho Jeong		compr_new_inode to "0".
5068939a848SChao Yu
5078939a848SChao YuWhat:		/sys/fs/f2fs/<disk>/atgc_candidate_ratio
5088939a848SChao YuDate:		May 2021
5098939a848SChao YuContact:	"Chao Yu" <yuchao0@huawei.com>
5108939a848SChao YuDescription:	When ATGC is on, it controls candidate ratio in order to limit total
5118939a848SChao Yu		number of potential victim in all candidates, the value should be in
5128939a848SChao Yu		range of [0, 100], by default it was initialized as 20(%).
5138939a848SChao Yu
5148939a848SChao YuWhat:		/sys/fs/f2fs/<disk>/atgc_candidate_count
5158939a848SChao YuDate:		May 2021
5168939a848SChao YuContact:	"Chao Yu" <yuchao0@huawei.com>
5178939a848SChao YuDescription:	When ATGC is on, it controls candidate count in order to limit total
5188939a848SChao Yu		number of potential victim in all candidates, by default it was
5198939a848SChao Yu		initialized as 10 (sections).
5208939a848SChao Yu
5218939a848SChao YuWhat:		/sys/fs/f2fs/<disk>/atgc_age_weight
5228939a848SChao YuDate:		May 2021
5238939a848SChao YuContact:	"Chao Yu" <yuchao0@huawei.com>
5248939a848SChao YuDescription:	When ATGC is on, it controls age weight to balance weight proportion
5258939a848SChao Yu		in between aging and valid blocks, the value should be in range of
5268939a848SChao Yu		[0, 100], by default it was initialized as 60(%).
5278939a848SChao Yu
5288939a848SChao YuWhat:		/sys/fs/f2fs/<disk>/atgc_age_threshold
5298939a848SChao YuDate:		May 2021
5308939a848SChao YuContact:	"Chao Yu" <yuchao0@huawei.com>
5318939a848SChao YuDescription:	When ATGC is on, it controls age threshold to bypass GCing young
5328939a848SChao Yu		candidates whose age is not beyond the threshold, by default it was
5338939a848SChao Yu		initialized as 604800 seconds (equals to 7 days).
53407c6b593SDaeho Jeong
53507c6b593SDaeho JeongWhat:		/sys/fs/f2fs/<disk>/gc_reclaimed_segments
53607c6b593SDaeho JeongDate:		July 2021
53707c6b593SDaeho JeongContact:	"Daeho Jeong" <daehojeong@google.com>
53807c6b593SDaeho JeongDescription:	Show how many segments have been reclaimed by GC during a specific
53907c6b593SDaeho Jeong		GC mode (0: GC normal, 1: GC idle CB, 2: GC idle greedy,
540d98af5f4SDaeho Jeong		3: GC idle AT, 4: GC urgent high, 5: GC urgent low 6: GC urgent mid)
54107c6b593SDaeho Jeong		You can re-initialize this value to "0".
54207c6b593SDaeho Jeong
54307c6b593SDaeho JeongWhat:		/sys/fs/f2fs/<disk>/gc_segment_mode
54407c6b593SDaeho JeongDate:		July 2021
54507c6b593SDaeho JeongContact:	"Daeho Jeong" <daehojeong@google.com>
54607c6b593SDaeho JeongDescription:	You can control for which gc mode the "gc_reclaimed_segments" node shows.
54707c6b593SDaeho Jeong		Refer to the description of the modes in "gc_reclaimed_segments".
5480f6b56ecSDaeho Jeong
5490f6b56ecSDaeho JeongWhat:		/sys/fs/f2fs/<disk>/seq_file_ra_mul
5500f6b56ecSDaeho JeongDate:		July 2021
5510f6b56ecSDaeho JeongContact:	"Daeho Jeong" <daehojeong@google.com>
5520f6b56ecSDaeho JeongDescription:	You can	control the multiplier value of	bdi device readahead window size
5530f6b56ecSDaeho Jeong		between 2 (default) and 256 for POSIX_FADV_SEQUENTIAL advise option.
5546691d940SDaeho Jeong
5556691d940SDaeho JeongWhat:		/sys/fs/f2fs/<disk>/max_fragment_chunk
5566691d940SDaeho JeongDate:		August 2021
5576691d940SDaeho JeongContact:	"Daeho Jeong" <daehojeong@google.com>
5586691d940SDaeho JeongDescription:	With "mode=fragment:block" mount options, we can scatter block allocation.
5596691d940SDaeho Jeong		f2fs will allocate 1..<max_fragment_chunk> blocks in a chunk and make a hole
5606691d940SDaeho Jeong		in the length of 1..<max_fragment_hole> by turns. This value can be set
5616691d940SDaeho Jeong		between 1..512 and the default value is 4.
5626691d940SDaeho Jeong
5636691d940SDaeho JeongWhat:		/sys/fs/f2fs/<disk>/max_fragment_hole
5646691d940SDaeho JeongDate:		August 2021
5656691d940SDaeho JeongContact:	"Daeho Jeong" <daehojeong@google.com>
5666691d940SDaeho JeongDescription:	With "mode=fragment:block" mount options, we can scatter block allocation.
5676691d940SDaeho Jeong		f2fs will allocate 1..<max_fragment_chunk> blocks in a chunk and make a hole
5686691d940SDaeho Jeong		in the length of 1..<max_fragment_hole> by turns. This value can be set
5696691d940SDaeho Jeong		between 1..512 and the default value is 4.
570325163e9SDaeho Jeong
571325163e9SDaeho JeongWhat:		/sys/fs/f2fs/<disk>/gc_urgent_high_remaining
572325163e9SDaeho JeongDate:		December 2021
573325163e9SDaeho JeongContact:	"Daeho Jeong" <daehojeong@google.com>
574325163e9SDaeho JeongDescription:	You can set the trial count limit for GC urgent high mode with this value.
575325163e9SDaeho Jeong		If GC thread gets to the limit, the mode will turn back to GC normal mode.
576325163e9SDaeho Jeong		By default, the value is zero, which means there is no limit like before.
57747c8ebccSJaegeuk Kim
57847c8ebccSJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/max_roll_forward_node_blocks
57947c8ebccSJaegeuk KimDate:		January 2022
58047c8ebccSJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
58147c8ebccSJaegeuk KimDescription:	Controls max # of node block writes to be used for roll forward
58247c8ebccSJaegeuk Kim		recovery. This can limit the roll forward recovery time.
583*8e0f54a7SJaegeuk Kim
584*8e0f54a7SJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/unusable_blocks_per_sec
585*8e0f54a7SJaegeuk KimDate:		June 2022
586*8e0f54a7SJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
587*8e0f54a7SJaegeuk KimDescription:	Shows the number of unusable blocks in a section which was defined by
588*8e0f54a7SJaegeuk Kim		the zone capacity reported by underlying zoned device.
589