xref: /linux/Documentation/ABI/testing/sysfs-fs-f2fs (revision 377224c471188a2c9a838f919160546f4e842ab8)
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.
104*377224c4SChao Yu		 <deprecated>
10560b99b48SJaegeuk Kim
10660b99b48SJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/cp_interval
10760b99b48SJaegeuk KimDate:		October 2015
10860b99b48SJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
10960b99b48SJaegeuk KimDescription:
11060b99b48SJaegeuk Kim		 Controls the checkpoint timing.
111ea1a29a0SChao Yu
112d0239e1bSJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/idle_interval
113d0239e1bSJaegeuk KimDate:		January 2016
114d0239e1bSJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
115d0239e1bSJaegeuk KimDescription:
116d0239e1bSJaegeuk Kim		 Controls the idle timing.
117d0239e1bSJaegeuk Kim
118b32d73abSChao YuWhat:		/sys/fs/f2fs/<disk>/iostat_enable
119b32d73abSChao YuDate:		August 2017
120b32d73abSChao YuContact:	"Chao Yu" <yuchao0@huawei.com>
121b32d73abSChao YuDescription:
122b32d73abSChao Yu		 Controls to enable/disable IO stat.
123b32d73abSChao Yu
124ea1a29a0SChao YuWhat:		/sys/fs/f2fs/<disk>/ra_nid_pages
125ea1a29a0SChao YuDate:		October 2015
126ea1a29a0SChao YuContact:	"Chao Yu" <chao2.yu@samsung.com>
127ea1a29a0SChao YuDescription:
128ea1a29a0SChao Yu		 Controls the count of nid pages to be readaheaded.
1292304cb0cSChao Yu
1302304cb0cSChao YuWhat:		/sys/fs/f2fs/<disk>/dirty_nats_ratio
1312304cb0cSChao YuDate:		January 2016
1322304cb0cSChao YuContact:	"Chao Yu" <chao2.yu@samsung.com>
1332304cb0cSChao YuDescription:
1342304cb0cSChao Yu		 Controls dirty nat entries ratio threshold, if current
1352304cb0cSChao Yu		 ratio exceeds configured threshold, checkpoint will
1362304cb0cSChao Yu		 be triggered for flushing dirty nat entries.
1378f1dbbbbSShuoran Liu
1388f1dbbbbSShuoran LiuWhat:		/sys/fs/f2fs/<disk>/lifetime_write_kbytes
1398f1dbbbbSShuoran LiuDate:		January 2016
1408f1dbbbbSShuoran LiuContact:	"Shuoran Liu" <liushuoran@huawei.com>
1418f1dbbbbSShuoran LiuDescription:
1428f1dbbbbSShuoran Liu		 Shows total written kbytes issued to disk.
14356412894SChao Yu
144b32d73abSChao YuWhat:		/sys/fs/f2fs/<disk>/feature
145b32d73abSChao YuDate:		July 2017
146b32d73abSChao YuContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
147b32d73abSChao YuDescription:
148b32d73abSChao Yu		 Shows all enabled features in current device.
149b32d73abSChao Yu
15056412894SChao YuWhat:		/sys/fs/f2fs/<disk>/inject_rate
15156412894SChao YuDate:		May 2016
15256412894SChao YuContact:	"Sheng Yong" <shengyong1@huawei.com>
15356412894SChao YuDescription:
15456412894SChao Yu		 Controls the injection rate.
15556412894SChao Yu
15656412894SChao YuWhat:		/sys/fs/f2fs/<disk>/inject_type
15756412894SChao YuDate:		May 2016
15856412894SChao YuContact:	"Sheng Yong" <shengyong1@huawei.com>
15956412894SChao YuDescription:
16056412894SChao Yu		 Controls the injection type.
161daeb433eSChao Yu
162daeb433eSChao YuWhat:		/sys/fs/f2fs/<disk>/reserved_blocks
163daeb433eSChao YuDate:		June 2017
164daeb433eSChao YuContact:	"Chao Yu" <yuchao0@huawei.com>
165daeb433eSChao YuDescription:
16680d42145SYunlong Song		 Controls target reserved blocks in system, the threshold
16780d42145SYunlong Song		 is soft, it could exceed current available user space.
16880d42145SYunlong Song
16980d42145SYunlong SongWhat:		/sys/fs/f2fs/<disk>/current_reserved_blocks
17080d42145SYunlong SongDate:		October 2017
17180d42145SYunlong SongContact:	"Yunlong Song" <yunlong.song@huawei.com>
17280d42145SYunlong SongContact:	"Chao Yu" <yuchao0@huawei.com>
17380d42145SYunlong SongDescription:
17480d42145SYunlong Song		 Shows current reserved blocks in system, it may be temporarily
17580d42145SYunlong Song		 smaller than target_reserved_blocks, but will gradually
17680d42145SYunlong Song		 increase to target_reserved_blocks when more free blocks are
17780d42145SYunlong Song		 freed by user later.
178d9872a69SJaegeuk Kim
179d9872a69SJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/gc_urgent
180d9872a69SJaegeuk KimDate:		August 2017
181d9872a69SJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
182d9872a69SJaegeuk KimDescription:
183d9872a69SJaegeuk Kim		 Do background GC agressively
184d9872a69SJaegeuk Kim
185d9872a69SJaegeuk KimWhat:		/sys/fs/f2fs/<disk>/gc_urgent_sleep_time
186d9872a69SJaegeuk KimDate:		August 2017
187d9872a69SJaegeuk KimContact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
188d9872a69SJaegeuk KimDescription:
189d9872a69SJaegeuk Kim		 Controls sleep time of GC urgent mode
190f6df8f23SSheng Yong
191f6df8f23SSheng YongWhat:		/sys/fs/f2fs/<disk>/readdir_ra
192f6df8f23SSheng YongDate:		November 2017
193f6df8f23SSheng YongContact:	"Sheng Yong" <shengyong1@huawei.com>
194f6df8f23SSheng YongDescription:
195f6df8f23SSheng Yong		 Controls readahead inode block in readdir.
196846ae671SChao Yu
197846ae671SChao YuWhat:		/sys/fs/f2fs/<disk>/extension_list
198846ae671SChao YuDate:		Feburary 2018
199846ae671SChao YuContact:	"Chao Yu" <yuchao0@huawei.com>
200846ae671SChao YuDescription:
201846ae671SChao Yu		 Used to control configure extension list:
202846ae671SChao Yu		 - Query: cat /sys/fs/f2fs/<disk>/extension_list
203b6a06cbbSChao Yu		 - Add: echo '[h/c]extension' > /sys/fs/f2fs/<disk>/extension_list
204b6a06cbbSChao Yu		 - Del: echo '[h/c]!extension' > /sys/fs/f2fs/<disk>/extension_list
205b6a06cbbSChao Yu		 - [h] means add/del hot file extension
206b6a06cbbSChao Yu		 - [c] means add/del cold file extension
207