xref: /linux/Documentation/ABI/testing/sysfs-fs-f2fs (revision 71e2f4dd5a65bd8dbca0b77661e75eea471168f8)
1What:		/sys/fs/f2fs/<disk>/gc_max_sleep_time
2Date:		July 2013
3Contact:	"Namjae Jeon" <namjae.jeon@samsung.com>
4Description:
5		 Controls the maximun sleep time for gc_thread. Time
6		 is in milliseconds.
7
8What:		/sys/fs/f2fs/<disk>/gc_min_sleep_time
9Date:		July 2013
10Contact:	"Namjae Jeon" <namjae.jeon@samsung.com>
11Description:
12		 Controls the minimum sleep time for gc_thread. Time
13		 is in milliseconds.
14
15What:		/sys/fs/f2fs/<disk>/gc_no_gc_sleep_time
16Date:		July 2013
17Contact:	"Namjae Jeon" <namjae.jeon@samsung.com>
18Description:
19		 Controls the default sleep time for gc_thread. Time
20		 is in milliseconds.
21
22What:		/sys/fs/f2fs/<disk>/gc_idle
23Date:		July 2013
24Contact:	"Namjae Jeon" <namjae.jeon@samsung.com>
25Description:
26		 Controls the victim selection policy for garbage collection.
27
28What:		/sys/fs/f2fs/<disk>/reclaim_segments
29Date:		October 2013
30Contact:	"Jaegeuk Kim" <jaegeuk.kim@samsung.com>
31Description:
32		 Controls the issue rate of segment discard commands.
33
34What:		/sys/fs/f2fs/<disk>/ipu_policy
35Date:		November 2013
36Contact:	"Jaegeuk Kim" <jaegeuk.kim@samsung.com>
37Description:
38		 Controls the in-place-update policy.
39
40What:		/sys/fs/f2fs/<disk>/min_ipu_util
41Date:		November 2013
42Contact:	"Jaegeuk Kim" <jaegeuk.kim@samsung.com>
43Description:
44		 Controls the FS utilization condition for the in-place-update
45		 policies.
46
47What:		/sys/fs/f2fs/<disk>/min_fsync_blocks
48Date:		September 2014
49Contact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
50Description:
51		 Controls the dirty page count condition for the in-place-update
52		 policies.
53
54What:		/sys/fs/f2fs/<disk>/min_seq_blocks
55Date:		August 2018
56Contact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
57Description:
58		 Controls the dirty page count condition for batched sequential
59		 writes in ->writepages.
60
61
62What:		/sys/fs/f2fs/<disk>/min_hot_blocks
63Date:		March 2017
64Contact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
65Description:
66		 Controls the dirty page count condition for redefining hot data.
67
68What:		/sys/fs/f2fs/<disk>/min_ssr_sections
69Date:		October 2017
70Contact:	"Chao Yu" <yuchao0@huawei.com>
71Description:
72		 Controls the fee section threshold to trigger SSR allocation.
73
74What:		/sys/fs/f2fs/<disk>/max_small_discards
75Date:		November 2013
76Contact:	"Jaegeuk Kim" <jaegeuk.kim@samsung.com>
77Description:
78		 Controls the issue rate of small discard commands.
79
80What:          /sys/fs/f2fs/<disk>/discard_granularity
81Date:          July 2017
82Contact:       "Chao Yu" <yuchao0@huawei.com>
83Description:
84		Controls discard granularity of inner discard thread, inner thread
85		will not issue discards with size that is smaller than granularity.
86		The unit size is one block, now only support configuring in range
87		of [1, 512].
88
89What:          /sys/fs/f2fs/<disk>/umount_discard_timeout
90Date:          January 2019
91Contact:       "Jaegeuk Kim" <jaegeuk@kernel.org>
92Description:
93		Set timeout to issue discard commands during umount.
94		Default: 5 secs
95
96What:		/sys/fs/f2fs/<disk>/max_victim_search
97Date:		January 2014
98Contact:	"Jaegeuk Kim" <jaegeuk.kim@samsung.com>
99Description:
100		 Controls the number of trials to find a victim segment.
101
102What:		/sys/fs/f2fs/<disk>/migration_granularity
103Date:		October 2018
104Contact:	"Chao Yu" <yuchao0@huawei.com>
105Description:
106		 Controls migration granularity of garbage collection on large
107		 section, it can let GC move partial segment{s} of one section
108		 in one GC cycle, so that dispersing heavy overhead GC to
109		 multiple lightweight one.
110
111What:		/sys/fs/f2fs/<disk>/dir_level
112Date:		March 2014
113Contact:	"Jaegeuk Kim" <jaegeuk.kim@samsung.com>
114Description:
115		 Controls the directory level for large directory.
116
117What:		/sys/fs/f2fs/<disk>/ram_thresh
118Date:		March 2014
119Contact:	"Jaegeuk Kim" <jaegeuk.kim@samsung.com>
120Description:
121		 Controls the memory footprint used by f2fs.
122
123What:		/sys/fs/f2fs/<disk>/batched_trim_sections
124Date:		February 2015
125Contact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
126Description:
127		 Controls the trimming rate in batch mode.
128		 <deprecated>
129
130What:		/sys/fs/f2fs/<disk>/cp_interval
131Date:		October 2015
132Contact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
133Description:
134		 Controls the checkpoint timing.
135
136What:		/sys/fs/f2fs/<disk>/idle_interval
137Date:		January 2016
138Contact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
139Description:
140		 Controls the idle timing for all paths other than
141		 discard and gc path.
142
143What:		/sys/fs/f2fs/<disk>/discard_idle_interval
144Date:		September 2018
145Contact:	"Chao Yu" <yuchao0@huawei.com>
146Contact:	"Sahitya Tummala" <stummala@codeaurora.org>
147Description:
148		 Controls the idle timing for discard path.
149
150What:		/sys/fs/f2fs/<disk>/gc_idle_interval
151Date:		September 2018
152Contact:	"Chao Yu" <yuchao0@huawei.com>
153Contact:	"Sahitya Tummala" <stummala@codeaurora.org>
154Description:
155		 Controls the idle timing for gc path.
156
157What:		/sys/fs/f2fs/<disk>/iostat_enable
158Date:		August 2017
159Contact:	"Chao Yu" <yuchao0@huawei.com>
160Description:
161		 Controls to enable/disable IO stat.
162
163What:		/sys/fs/f2fs/<disk>/ra_nid_pages
164Date:		October 2015
165Contact:	"Chao Yu" <chao2.yu@samsung.com>
166Description:
167		 Controls the count of nid pages to be readaheaded.
168
169What:		/sys/fs/f2fs/<disk>/dirty_nats_ratio
170Date:		January 2016
171Contact:	"Chao Yu" <chao2.yu@samsung.com>
172Description:
173		 Controls dirty nat entries ratio threshold, if current
174		 ratio exceeds configured threshold, checkpoint will
175		 be triggered for flushing dirty nat entries.
176
177What:		/sys/fs/f2fs/<disk>/lifetime_write_kbytes
178Date:		January 2016
179Contact:	"Shuoran Liu" <liushuoran@huawei.com>
180Description:
181		 Shows total written kbytes issued to disk.
182
183What:		/sys/fs/f2fs/<disk>/features
184Date:		July 2017
185Contact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
186Description:
187		 Shows all enabled features in current device.
188
189What:		/sys/fs/f2fs/<disk>/inject_rate
190Date:		May 2016
191Contact:	"Sheng Yong" <shengyong1@huawei.com>
192Description:
193		 Controls the injection rate.
194
195What:		/sys/fs/f2fs/<disk>/inject_type
196Date:		May 2016
197Contact:	"Sheng Yong" <shengyong1@huawei.com>
198Description:
199		 Controls the injection type.
200
201What:		/sys/fs/f2fs/<disk>/reserved_blocks
202Date:		June 2017
203Contact:	"Chao Yu" <yuchao0@huawei.com>
204Description:
205		 Controls target reserved blocks in system, the threshold
206		 is soft, it could exceed current available user space.
207
208What:		/sys/fs/f2fs/<disk>/current_reserved_blocks
209Date:		October 2017
210Contact:	"Yunlong Song" <yunlong.song@huawei.com>
211Contact:	"Chao Yu" <yuchao0@huawei.com>
212Description:
213		 Shows current reserved blocks in system, it may be temporarily
214		 smaller than target_reserved_blocks, but will gradually
215		 increase to target_reserved_blocks when more free blocks are
216		 freed by user later.
217
218What:		/sys/fs/f2fs/<disk>/gc_urgent
219Date:		August 2017
220Contact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
221Description:
222		 Do background GC agressively
223
224What:		/sys/fs/f2fs/<disk>/gc_urgent_sleep_time
225Date:		August 2017
226Contact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
227Description:
228		 Controls sleep time of GC urgent mode
229
230What:		/sys/fs/f2fs/<disk>/readdir_ra
231Date:		November 2017
232Contact:	"Sheng Yong" <shengyong1@huawei.com>
233Description:
234		 Controls readahead inode block in readdir.
235
236What:		/sys/fs/f2fs/<disk>/extension_list
237Date:		Feburary 2018
238Contact:	"Chao Yu" <yuchao0@huawei.com>
239Description:
240		 Used to control configure extension list:
241		 - Query: cat /sys/fs/f2fs/<disk>/extension_list
242		 - Add: echo '[h/c]extension' > /sys/fs/f2fs/<disk>/extension_list
243		 - Del: echo '[h/c]!extension' > /sys/fs/f2fs/<disk>/extension_list
244		 - [h] means add/del hot file extension
245		 - [c] means add/del cold file extension
246
247What:		/sys/fs/f2fs/<disk>/unusable
248Date		April 2019
249Contact:	"Daniel Rosenberg" <drosen@google.com>
250Description:
251		If checkpoint=disable, it displays the number of blocks that are unusable.
252                If checkpoint=enable it displays the enumber of blocks that would be unusable
253                if checkpoint=disable were to be set.
254
255What:		/sys/fs/f2fs/<disk>/encoding
256Date		July 2019
257Contact:	"Daniel Rosenberg" <drosen@google.com>
258Description:
259		Displays name and version of the encoding set for the filesystem.
260                If no encoding is set, displays (none)
261