xref: /linux/Documentation/ABI/testing/sysfs-fs-f2fs (revision 853137cef46ccc490e6fd4b160a1c252d6459842)
1b59d0baeSNamjae JeonWhat:		/sys/fs/f2fs/<disk>/gc_max_sleep_time
2b59d0baeSNamjae JeonDate:		July 2013
3b59d0baeSNamjae JeonContact:	"Namjae Jeon" <namjae.jeon@samsung.com>
4b59d0baeSNamjae JeonDescription:
5b59d0baeSNamjae Jeon		 Controls the maximun sleep time for gc_thread. Time
6b59d0baeSNamjae Jeon		 is in milliseconds.
7b59d0baeSNamjae Jeon
8b59d0baeSNamjae JeonWhat:		/sys/fs/f2fs/<disk>/gc_min_sleep_time
9b59d0baeSNamjae JeonDate:		July 2013
10b59d0baeSNamjae JeonContact:	"Namjae Jeon" <namjae.jeon@samsung.com>
11b59d0baeSNamjae JeonDescription:
12b59d0baeSNamjae Jeon		 Controls the minimum sleep time for gc_thread. Time
13b59d0baeSNamjae Jeon		 is in milliseconds.
14b59d0baeSNamjae Jeon
15b59d0baeSNamjae JeonWhat:		/sys/fs/f2fs/<disk>/gc_no_gc_sleep_time
16b59d0baeSNamjae JeonDate:		July 2013
17b59d0baeSNamjae JeonContact:	"Namjae Jeon" <namjae.jeon@samsung.com>
18b59d0baeSNamjae JeonDescription:
19b59d0baeSNamjae Jeon		 Controls the default sleep time for gc_thread. Time
20b59d0baeSNamjae Jeon		 is in milliseconds.
21d2dc095fSNamjae Jeon
22d2dc095fSNamjae JeonWhat:		/sys/fs/f2fs/<disk>/gc_idle
23d2dc095fSNamjae JeonDate:		July 2013
24d2dc095fSNamjae JeonContact:	"Namjae Jeon" <namjae.jeon@samsung.com>
25d2dc095fSNamjae JeonDescription:
26d2dc095fSNamjae Jeon		 Controls the victim selection policy for garbage collection.
273bac380cSJaegeuk Kim
283bac380cSJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/reclaim_segments
293bac380cSJaegeuk KimDate:		October 2013
303bac380cSJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk.kim@samsung.com>
313bac380cSJaegeuk KimDescription:
323bac380cSJaegeuk Kim		 Controls the issue rate of segment discard commands.
333bac380cSJaegeuk Kim
343bac380cSJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/ipu_policy
353bac380cSJaegeuk KimDate:		November 2013
363bac380cSJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk.kim@samsung.com>
373bac380cSJaegeuk KimDescription:
383bac380cSJaegeuk Kim		 Controls the in-place-update policy.
393bac380cSJaegeuk Kim
403bac380cSJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/min_ipu_util
413bac380cSJaegeuk KimDate:		November 2013
423bac380cSJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk.kim@samsung.com>
433bac380cSJaegeuk KimDescription:
443bac380cSJaegeuk Kim		 Controls the FS utilization condition for the in-place-update
453bac380cSJaegeuk Kim		 policies.
463bac380cSJaegeuk Kim
47c1ce1b02SJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/min_fsync_blocks
48c1ce1b02SJaegeuk KimDate:		September 2014
49c1ce1b02SJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
50c1ce1b02SJaegeuk KimDescription:
51c1ce1b02SJaegeuk Kim		 Controls the dirty page count condition for the in-place-update
52c1ce1b02SJaegeuk Kim		 policies.
53c1ce1b02SJaegeuk Kim
54*853137ceSJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/min_seq_blocks
55*853137ceSJaegeuk KimDate:		August 2018
56*853137ceSJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
57*853137ceSJaegeuk KimDescription:
58*853137ceSJaegeuk Kim		 Controls the dirty page count condition for batched sequential
59*853137ceSJaegeuk Kim		 writes in ->writepages.
60*853137ceSJaegeuk Kim
61*853137ceSJaegeuk Kim
62b32d73abSChao YuWhat:		/sys/fs/f2fs/<disk>/min_hot_blocks
63b32d73abSChao YuDate:		March 2017
64b32d73abSChao YuContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
65b32d73abSChao YuDescription:
66b32d73abSChao Yu		 Controls the dirty page count condition for redefining hot data.
67b32d73abSChao Yu
68a2a12b67SChao YuWhat:		/sys/fs/f2fs/<disk>/min_ssr_sections
69a2a12b67SChao YuDate:		October 2017
70a2a12b67SChao YuContact:	"Chao Yu" <yuchao0@huawei.com>
71a2a12b67SChao YuDescription:
72a2a12b67SChao Yu		 Controls the fee section threshold to trigger SSR allocation.
73a2a12b67SChao Yu
743bac380cSJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/max_small_discards
753bac380cSJaegeuk KimDate:		November 2013
763bac380cSJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk.kim@samsung.com>
773bac380cSJaegeuk KimDescription:
783bac380cSJaegeuk Kim		 Controls the issue rate of small discard commands.
793bac380cSJaegeuk Kim
80969d1b18SChao YuWhat:          /sys/fs/f2fs/<disk>/discard_granularity
81969d1b18SChao YuDate:          July 2017
82969d1b18SChao YuContact:       "Chao Yu" <yuchao0@huawei.com>
83969d1b18SChao YuDescription:
84969d1b18SChao Yu		Controls discard granularity of inner discard thread, inner thread
85969d1b18SChao Yu		will not issue discards with size that is smaller than granularity.
86969d1b18SChao Yu		The unit size is one block, now only support configuring in range
87969d1b18SChao Yu		of [1, 512].
88969d1b18SChao Yu
893bac380cSJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/max_victim_search
903bac380cSJaegeuk KimDate:		January 2014
913bac380cSJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk.kim@samsung.com>
923bac380cSJaegeuk KimDescription:
933bac380cSJaegeuk Kim		 Controls the number of trials to find a victim segment.
94cdfc41c1SJaegeuk Kim
9591796825SJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/dir_level
9691796825SJaegeuk KimDate:		March 2014
9791796825SJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk.kim@samsung.com>
9891796825SJaegeuk KimDescription:
9991796825SJaegeuk Kim		 Controls the directory level for large directory.
10091796825SJaegeuk Kim
101cdfc41c1SJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/ram_thresh
102cdfc41c1SJaegeuk KimDate:		March 2014
103cdfc41c1SJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk.kim@samsung.com>
104cdfc41c1SJaegeuk KimDescription:
105cdfc41c1SJaegeuk Kim		 Controls the memory footprint used by f2fs.
106bba681cbSJaegeuk Kim
1076f6d9fe2SChao YuWhat:		/sys/fs/f2fs/<disk>/batched_trim_sections
108bba681cbSJaegeuk KimDate:		February 2015
109bba681cbSJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
110bba681cbSJaegeuk KimDescription:
111bba681cbSJaegeuk Kim		 Controls the trimming rate in batch mode.
112377224c4SChao Yu		 <deprecated>
11360b99b48SJaegeuk Kim
11460b99b48SJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/cp_interval
11560b99b48SJaegeuk KimDate:		October 2015
11660b99b48SJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
11760b99b48SJaegeuk KimDescription:
11860b99b48SJaegeuk Kim		 Controls the checkpoint timing.
119ea1a29a0SChao Yu
120d0239e1bSJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/idle_interval
121d0239e1bSJaegeuk KimDate:		January 2016
122d0239e1bSJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
123d0239e1bSJaegeuk KimDescription:
124d0239e1bSJaegeuk Kim		 Controls the idle timing.
125d0239e1bSJaegeuk Kim
126b32d73abSChao YuWhat:		/sys/fs/f2fs/<disk>/iostat_enable
127b32d73abSChao YuDate:		August 2017
128b32d73abSChao YuContact:	"Chao Yu" <yuchao0@huawei.com>
129b32d73abSChao YuDescription:
130b32d73abSChao Yu		 Controls to enable/disable IO stat.
131b32d73abSChao Yu
132ea1a29a0SChao YuWhat:		/sys/fs/f2fs/<disk>/ra_nid_pages
133ea1a29a0SChao YuDate:		October 2015
134ea1a29a0SChao YuContact:	"Chao Yu" <chao2.yu@samsung.com>
135ea1a29a0SChao YuDescription:
136ea1a29a0SChao Yu		 Controls the count of nid pages to be readaheaded.
1372304cb0cSChao Yu
1382304cb0cSChao YuWhat:		/sys/fs/f2fs/<disk>/dirty_nats_ratio
1392304cb0cSChao YuDate:		January 2016
1402304cb0cSChao YuContact:	"Chao Yu" <chao2.yu@samsung.com>
1412304cb0cSChao YuDescription:
1422304cb0cSChao Yu		 Controls dirty nat entries ratio threshold, if current
1432304cb0cSChao Yu		 ratio exceeds configured threshold, checkpoint will
1442304cb0cSChao Yu		 be triggered for flushing dirty nat entries.
1458f1dbbbbSShuoran Liu
1468f1dbbbbSShuoran LiuWhat:		/sys/fs/f2fs/<disk>/lifetime_write_kbytes
1478f1dbbbbSShuoran LiuDate:		January 2016
1488f1dbbbbSShuoran LiuContact:	"Shuoran Liu" <liushuoran@huawei.com>
1498f1dbbbbSShuoran LiuDescription:
1508f1dbbbbSShuoran Liu		 Shows total written kbytes issued to disk.
15156412894SChao Yu
1529ac19faaSEric BiggersWhat:		/sys/fs/f2fs/<disk>/features
153b32d73abSChao YuDate:		July 2017
154b32d73abSChao YuContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
155b32d73abSChao YuDescription:
156b32d73abSChao Yu		 Shows all enabled features in current device.
157b32d73abSChao Yu
15856412894SChao YuWhat:		/sys/fs/f2fs/<disk>/inject_rate
15956412894SChao YuDate:		May 2016
16056412894SChao YuContact:	"Sheng Yong" <shengyong1@huawei.com>
16156412894SChao YuDescription:
16256412894SChao Yu		 Controls the injection rate.
16356412894SChao Yu
16456412894SChao YuWhat:		/sys/fs/f2fs/<disk>/inject_type
16556412894SChao YuDate:		May 2016
16656412894SChao YuContact:	"Sheng Yong" <shengyong1@huawei.com>
16756412894SChao YuDescription:
16856412894SChao Yu		 Controls the injection type.
169daeb433eSChao Yu
170daeb433eSChao YuWhat:		/sys/fs/f2fs/<disk>/reserved_blocks
171daeb433eSChao YuDate:		June 2017
172daeb433eSChao YuContact:	"Chao Yu" <yuchao0@huawei.com>
173daeb433eSChao YuDescription:
17480d42145SYunlong Song		 Controls target reserved blocks in system, the threshold
17580d42145SYunlong Song		 is soft, it could exceed current available user space.
17680d42145SYunlong Song
17780d42145SYunlong SongWhat:		/sys/fs/f2fs/<disk>/current_reserved_blocks
17880d42145SYunlong SongDate:		October 2017
17980d42145SYunlong SongContact:	"Yunlong Song" <yunlong.song@huawei.com>
18080d42145SYunlong SongContact:	"Chao Yu" <yuchao0@huawei.com>
18180d42145SYunlong SongDescription:
18280d42145SYunlong Song		 Shows current reserved blocks in system, it may be temporarily
18380d42145SYunlong Song		 smaller than target_reserved_blocks, but will gradually
18480d42145SYunlong Song		 increase to target_reserved_blocks when more free blocks are
18580d42145SYunlong Song		 freed by user later.
186d9872a69SJaegeuk Kim
187d9872a69SJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/gc_urgent
188d9872a69SJaegeuk KimDate:		August 2017
189d9872a69SJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
190d9872a69SJaegeuk KimDescription:
191d9872a69SJaegeuk Kim		 Do background GC agressively
192d9872a69SJaegeuk Kim
193d9872a69SJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/gc_urgent_sleep_time
194d9872a69SJaegeuk KimDate:		August 2017
195d9872a69SJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
196d9872a69SJaegeuk KimDescription:
197d9872a69SJaegeuk Kim		 Controls sleep time of GC urgent mode
198f6df8f23SSheng Yong
199f6df8f23SSheng YongWhat:		/sys/fs/f2fs/<disk>/readdir_ra
200f6df8f23SSheng YongDate:		November 2017
201f6df8f23SSheng YongContact:	"Sheng Yong" <shengyong1@huawei.com>
202f6df8f23SSheng YongDescription:
203f6df8f23SSheng Yong		 Controls readahead inode block in readdir.
204846ae671SChao Yu
205846ae671SChao YuWhat:		/sys/fs/f2fs/<disk>/extension_list
206846ae671SChao YuDate:		Feburary 2018
207846ae671SChao YuContact:	"Chao Yu" <yuchao0@huawei.com>
208846ae671SChao YuDescription:
209846ae671SChao Yu		 Used to control configure extension list:
210846ae671SChao Yu		 - Query: cat /sys/fs/f2fs/<disk>/extension_list
211b6a06cbbSChao Yu		 - Add: echo '[h/c]extension' > /sys/fs/f2fs/<disk>/extension_list
212b6a06cbbSChao Yu		 - Del: echo '[h/c]!extension' > /sys/fs/f2fs/<disk>/extension_list
213b6a06cbbSChao Yu		 - [h] means add/del hot file extension
214b6a06cbbSChao Yu		 - [c] means add/del cold file extension
215