xref: /linux/Documentation/ABI/testing/sysfs-fs-f2fs (revision 846ae671ad368e344a2b141c0f19e1014b27a0dd)
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
54b32d73abSChao YuWhat:		/sys/fs/f2fs/<disk>/min_hot_blocks
55b32d73abSChao YuDate:		March 2017
56b32d73abSChao YuContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
57b32d73abSChao YuDescription:
58b32d73abSChao Yu		 Controls the dirty page count condition for redefining hot data.
59b32d73abSChao Yu
60a2a12b67SChao YuWhat:		/sys/fs/f2fs/<disk>/min_ssr_sections
61a2a12b67SChao YuDate:		October 2017
62a2a12b67SChao YuContact:	"Chao Yu" <yuchao0@huawei.com>
63a2a12b67SChao YuDescription:
64a2a12b67SChao Yu		 Controls the fee section threshold to trigger SSR allocation.
65a2a12b67SChao Yu
663bac380cSJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/max_small_discards
673bac380cSJaegeuk KimDate:		November 2013
683bac380cSJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk.kim@samsung.com>
693bac380cSJaegeuk KimDescription:
703bac380cSJaegeuk Kim		 Controls the issue rate of small discard commands.
713bac380cSJaegeuk Kim
72969d1b18SChao YuWhat:          /sys/fs/f2fs/<disk>/discard_granularity
73969d1b18SChao YuDate:          July 2017
74969d1b18SChao YuContact:       "Chao Yu" <yuchao0@huawei.com>
75969d1b18SChao YuDescription:
76969d1b18SChao Yu		Controls discard granularity of inner discard thread, inner thread
77969d1b18SChao Yu		will not issue discards with size that is smaller than granularity.
78969d1b18SChao Yu		The unit size is one block, now only support configuring in range
79969d1b18SChao Yu		of [1, 512].
80969d1b18SChao Yu
813bac380cSJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/max_victim_search
823bac380cSJaegeuk KimDate:		January 2014
833bac380cSJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk.kim@samsung.com>
843bac380cSJaegeuk KimDescription:
853bac380cSJaegeuk Kim		 Controls the number of trials to find a victim segment.
86cdfc41c1SJaegeuk Kim
8791796825SJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/dir_level
8891796825SJaegeuk KimDate:		March 2014
8991796825SJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk.kim@samsung.com>
9091796825SJaegeuk KimDescription:
9191796825SJaegeuk Kim		 Controls the directory level for large directory.
9291796825SJaegeuk Kim
93cdfc41c1SJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/ram_thresh
94cdfc41c1SJaegeuk KimDate:		March 2014
95cdfc41c1SJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk.kim@samsung.com>
96cdfc41c1SJaegeuk KimDescription:
97cdfc41c1SJaegeuk Kim		 Controls the memory footprint used by f2fs.
98bba681cbSJaegeuk Kim
996f6d9fe2SChao YuWhat:		/sys/fs/f2fs/<disk>/batched_trim_sections
100bba681cbSJaegeuk KimDate:		February 2015
101bba681cbSJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
102bba681cbSJaegeuk KimDescription:
103bba681cbSJaegeuk Kim		 Controls the trimming rate in batch mode.
10460b99b48SJaegeuk Kim
10560b99b48SJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/cp_interval
10660b99b48SJaegeuk KimDate:		October 2015
10760b99b48SJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
10860b99b48SJaegeuk KimDescription:
10960b99b48SJaegeuk Kim		 Controls the checkpoint timing.
110ea1a29a0SChao Yu
111d0239e1bSJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/idle_interval
112d0239e1bSJaegeuk KimDate:		January 2016
113d0239e1bSJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
114d0239e1bSJaegeuk KimDescription:
115d0239e1bSJaegeuk Kim		 Controls the idle timing.
116d0239e1bSJaegeuk Kim
117b32d73abSChao YuWhat:		/sys/fs/f2fs/<disk>/iostat_enable
118b32d73abSChao YuDate:		August 2017
119b32d73abSChao YuContact:	"Chao Yu" <yuchao0@huawei.com>
120b32d73abSChao YuDescription:
121b32d73abSChao Yu		 Controls to enable/disable IO stat.
122b32d73abSChao Yu
123ea1a29a0SChao YuWhat:		/sys/fs/f2fs/<disk>/ra_nid_pages
124ea1a29a0SChao YuDate:		October 2015
125ea1a29a0SChao YuContact:	"Chao Yu" <chao2.yu@samsung.com>
126ea1a29a0SChao YuDescription:
127ea1a29a0SChao Yu		 Controls the count of nid pages to be readaheaded.
1282304cb0cSChao Yu
1292304cb0cSChao YuWhat:		/sys/fs/f2fs/<disk>/dirty_nats_ratio
1302304cb0cSChao YuDate:		January 2016
1312304cb0cSChao YuContact:	"Chao Yu" <chao2.yu@samsung.com>
1322304cb0cSChao YuDescription:
1332304cb0cSChao Yu		 Controls dirty nat entries ratio threshold, if current
1342304cb0cSChao Yu		 ratio exceeds configured threshold, checkpoint will
1352304cb0cSChao Yu		 be triggered for flushing dirty nat entries.
1368f1dbbbbSShuoran Liu
1378f1dbbbbSShuoran LiuWhat:		/sys/fs/f2fs/<disk>/lifetime_write_kbytes
1388f1dbbbbSShuoran LiuDate:		January 2016
1398f1dbbbbSShuoran LiuContact:	"Shuoran Liu" <liushuoran@huawei.com>
1408f1dbbbbSShuoran LiuDescription:
1418f1dbbbbSShuoran Liu		 Shows total written kbytes issued to disk.
14256412894SChao Yu
143b32d73abSChao YuWhat:		/sys/fs/f2fs/<disk>/feature
144b32d73abSChao YuDate:		July 2017
145b32d73abSChao YuContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
146b32d73abSChao YuDescription:
147b32d73abSChao Yu		 Shows all enabled features in current device.
148b32d73abSChao Yu
14956412894SChao YuWhat:		/sys/fs/f2fs/<disk>/inject_rate
15056412894SChao YuDate:		May 2016
15156412894SChao YuContact:	"Sheng Yong" <shengyong1@huawei.com>
15256412894SChao YuDescription:
15356412894SChao Yu		 Controls the injection rate.
15456412894SChao Yu
15556412894SChao YuWhat:		/sys/fs/f2fs/<disk>/inject_type
15656412894SChao YuDate:		May 2016
15756412894SChao YuContact:	"Sheng Yong" <shengyong1@huawei.com>
15856412894SChao YuDescription:
15956412894SChao Yu		 Controls the injection type.
160daeb433eSChao Yu
161daeb433eSChao YuWhat:		/sys/fs/f2fs/<disk>/reserved_blocks
162daeb433eSChao YuDate:		June 2017
163daeb433eSChao YuContact:	"Chao Yu" <yuchao0@huawei.com>
164daeb433eSChao YuDescription:
16580d42145SYunlong Song		 Controls target reserved blocks in system, the threshold
16680d42145SYunlong Song		 is soft, it could exceed current available user space.
16780d42145SYunlong Song
16880d42145SYunlong SongWhat:		/sys/fs/f2fs/<disk>/current_reserved_blocks
16980d42145SYunlong SongDate:		October 2017
17080d42145SYunlong SongContact:	"Yunlong Song" <yunlong.song@huawei.com>
17180d42145SYunlong SongContact:	"Chao Yu" <yuchao0@huawei.com>
17280d42145SYunlong SongDescription:
17380d42145SYunlong Song		 Shows current reserved blocks in system, it may be temporarily
17480d42145SYunlong Song		 smaller than target_reserved_blocks, but will gradually
17580d42145SYunlong Song		 increase to target_reserved_blocks when more free blocks are
17680d42145SYunlong Song		 freed by user later.
177d9872a69SJaegeuk Kim
178d9872a69SJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/gc_urgent
179d9872a69SJaegeuk KimDate:		August 2017
180d9872a69SJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
181d9872a69SJaegeuk KimDescription:
182d9872a69SJaegeuk Kim		 Do background GC agressively
183d9872a69SJaegeuk Kim
184d9872a69SJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/gc_urgent_sleep_time
185d9872a69SJaegeuk KimDate:		August 2017
186d9872a69SJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
187d9872a69SJaegeuk KimDescription:
188d9872a69SJaegeuk Kim		 Controls sleep time of GC urgent mode
189f6df8f23SSheng Yong
190f6df8f23SSheng YongWhat:		/sys/fs/f2fs/<disk>/readdir_ra
191f6df8f23SSheng YongDate:		November 2017
192f6df8f23SSheng YongContact:	"Sheng Yong" <shengyong1@huawei.com>
193f6df8f23SSheng YongDescription:
194f6df8f23SSheng Yong		 Controls readahead inode block in readdir.
195*846ae671SChao Yu
196*846ae671SChao YuWhat:		/sys/fs/f2fs/<disk>/extension_list
197*846ae671SChao YuDate:		Feburary 2018
198*846ae671SChao YuContact:	"Chao Yu" <yuchao0@huawei.com>
199*846ae671SChao YuDescription:
200*846ae671SChao Yu		 Used to control configure extension list:
201*846ae671SChao Yu		 - Query: cat /sys/fs/f2fs/<disk>/extension_list
202*846ae671SChao Yu		 - Add: echo 'extension' > /sys/fs/f2fs/<disk>/extension_list
203*846ae671SChao Yu		 - Del: echo '!extension' > /sys/fs/f2fs/<disk>/extension_list
204