GNU Linux-libre 4.19.264-gnu1
[releases.git] / Documentation / ABI / testing / sysfs-fs-f2fs
1 What:           /sys/fs/f2fs/<disk>/gc_max_sleep_time
2 Date:           July 2013
3 Contact:        "Namjae Jeon" <namjae.jeon@samsung.com>
4 Description:
5                  Controls the maximun sleep time for gc_thread. Time
6                  is in milliseconds.
7
8 What:           /sys/fs/f2fs/<disk>/gc_min_sleep_time
9 Date:           July 2013
10 Contact:        "Namjae Jeon" <namjae.jeon@samsung.com>
11 Description:
12                  Controls the minimum sleep time for gc_thread. Time
13                  is in milliseconds.
14
15 What:           /sys/fs/f2fs/<disk>/gc_no_gc_sleep_time
16 Date:           July 2013
17 Contact:        "Namjae Jeon" <namjae.jeon@samsung.com>
18 Description:
19                  Controls the default sleep time for gc_thread. Time
20                  is in milliseconds.
21
22 What:           /sys/fs/f2fs/<disk>/gc_idle
23 Date:           July 2013
24 Contact:        "Namjae Jeon" <namjae.jeon@samsung.com>
25 Description:
26                  Controls the victim selection policy for garbage collection.
27
28 What:           /sys/fs/f2fs/<disk>/reclaim_segments
29 Date:           October 2013
30 Contact:        "Jaegeuk Kim" <jaegeuk.kim@samsung.com>
31 Description:
32                  Controls the issue rate of segment discard commands.
33
34 What:           /sys/fs/f2fs/<disk>/ipu_policy
35 Date:           November 2013
36 Contact:        "Jaegeuk Kim" <jaegeuk.kim@samsung.com>
37 Description:
38                  Controls the in-place-update policy.
39
40 What:           /sys/fs/f2fs/<disk>/min_ipu_util
41 Date:           November 2013
42 Contact:        "Jaegeuk Kim" <jaegeuk.kim@samsung.com>
43 Description:
44                  Controls the FS utilization condition for the in-place-update
45                  policies.
46
47 What:           /sys/fs/f2fs/<disk>/min_fsync_blocks
48 Date:           September 2014
49 Contact:        "Jaegeuk Kim" <jaegeuk@kernel.org>
50 Description:
51                  Controls the dirty page count condition for the in-place-update
52                  policies.
53
54 What:           /sys/fs/f2fs/<disk>/min_seq_blocks
55 Date:           August 2018
56 Contact:        "Jaegeuk Kim" <jaegeuk@kernel.org>
57 Description:
58                  Controls the dirty page count condition for batched sequential
59                  writes in ->writepages.
60
61
62 What:           /sys/fs/f2fs/<disk>/min_hot_blocks
63 Date:           March 2017
64 Contact:        "Jaegeuk Kim" <jaegeuk@kernel.org>
65 Description:
66                  Controls the dirty page count condition for redefining hot data.
67
68 What:           /sys/fs/f2fs/<disk>/min_ssr_sections
69 Date:           October 2017
70 Contact:        "Chao Yu" <yuchao0@huawei.com>
71 Description:
72                  Controls the fee section threshold to trigger SSR allocation.
73
74 What:           /sys/fs/f2fs/<disk>/max_small_discards
75 Date:           November 2013
76 Contact:        "Jaegeuk Kim" <jaegeuk.kim@samsung.com>
77 Description:
78                  Controls the issue rate of small discard commands.
79
80 What:          /sys/fs/f2fs/<disk>/discard_granularity
81 Date:          July 2017
82 Contact:       "Chao Yu" <yuchao0@huawei.com>
83 Description:
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
89 What:           /sys/fs/f2fs/<disk>/max_victim_search
90 Date:           January 2014
91 Contact:        "Jaegeuk Kim" <jaegeuk.kim@samsung.com>
92 Description:
93                  Controls the number of trials to find a victim segment.
94
95 What:           /sys/fs/f2fs/<disk>/dir_level
96 Date:           March 2014
97 Contact:        "Jaegeuk Kim" <jaegeuk.kim@samsung.com>
98 Description:
99                  Controls the directory level for large directory.
100
101 What:           /sys/fs/f2fs/<disk>/ram_thresh
102 Date:           March 2014
103 Contact:        "Jaegeuk Kim" <jaegeuk.kim@samsung.com>
104 Description:
105                  Controls the memory footprint used by f2fs.
106
107 What:           /sys/fs/f2fs/<disk>/batched_trim_sections
108 Date:           February 2015
109 Contact:        "Jaegeuk Kim" <jaegeuk@kernel.org>
110 Description:
111                  Controls the trimming rate in batch mode.
112                  <deprecated>
113
114 What:           /sys/fs/f2fs/<disk>/cp_interval
115 Date:           October 2015
116 Contact:        "Jaegeuk Kim" <jaegeuk@kernel.org>
117 Description:
118                  Controls the checkpoint timing.
119
120 What:           /sys/fs/f2fs/<disk>/idle_interval
121 Date:           January 2016
122 Contact:        "Jaegeuk Kim" <jaegeuk@kernel.org>
123 Description:
124                  Controls the idle timing.
125
126 What:           /sys/fs/f2fs/<disk>/iostat_enable
127 Date:           August 2017
128 Contact:        "Chao Yu" <yuchao0@huawei.com>
129 Description:
130                  Controls to enable/disable IO stat.
131
132 What:           /sys/fs/f2fs/<disk>/ra_nid_pages
133 Date:           October 2015
134 Contact:        "Chao Yu" <chao2.yu@samsung.com>
135 Description:
136                  Controls the count of nid pages to be readaheaded.
137
138 What:           /sys/fs/f2fs/<disk>/dirty_nats_ratio
139 Date:           January 2016
140 Contact:        "Chao Yu" <chao2.yu@samsung.com>
141 Description:
142                  Controls dirty nat entries ratio threshold, if current
143                  ratio exceeds configured threshold, checkpoint will
144                  be triggered for flushing dirty nat entries.
145
146 What:           /sys/fs/f2fs/<disk>/lifetime_write_kbytes
147 Date:           January 2016
148 Contact:        "Shuoran Liu" <liushuoran@huawei.com>
149 Description:
150                  Shows total written kbytes issued to disk.
151
152 What:           /sys/fs/f2fs/<disk>/features
153 Date:           July 2017
154 Contact:        "Jaegeuk Kim" <jaegeuk@kernel.org>
155 Description:
156                  Shows all enabled features in current device.
157
158 What:           /sys/fs/f2fs/<disk>/inject_rate
159 Date:           May 2016
160 Contact:        "Sheng Yong" <shengyong1@huawei.com>
161 Description:
162                  Controls the injection rate.
163
164 What:           /sys/fs/f2fs/<disk>/inject_type
165 Date:           May 2016
166 Contact:        "Sheng Yong" <shengyong1@huawei.com>
167 Description:
168                  Controls the injection type.
169
170 What:           /sys/fs/f2fs/<disk>/reserved_blocks
171 Date:           June 2017
172 Contact:        "Chao Yu" <yuchao0@huawei.com>
173 Description:
174                  Controls target reserved blocks in system, the threshold
175                  is soft, it could exceed current available user space.
176
177 What:           /sys/fs/f2fs/<disk>/current_reserved_blocks
178 Date:           October 2017
179 Contact:        "Yunlong Song" <yunlong.song@huawei.com>
180 Contact:        "Chao Yu" <yuchao0@huawei.com>
181 Description:
182                  Shows current reserved blocks in system, it may be temporarily
183                  smaller than target_reserved_blocks, but will gradually
184                  increase to target_reserved_blocks when more free blocks are
185                  freed by user later.
186
187 What:           /sys/fs/f2fs/<disk>/gc_urgent
188 Date:           August 2017
189 Contact:        "Jaegeuk Kim" <jaegeuk@kernel.org>
190 Description:
191                  Do background GC agressively
192
193 What:           /sys/fs/f2fs/<disk>/gc_urgent_sleep_time
194 Date:           August 2017
195 Contact:        "Jaegeuk Kim" <jaegeuk@kernel.org>
196 Description:
197                  Controls sleep time of GC urgent mode
198
199 What:           /sys/fs/f2fs/<disk>/readdir_ra
200 Date:           November 2017
201 Contact:        "Sheng Yong" <shengyong1@huawei.com>
202 Description:
203                  Controls readahead inode block in readdir.
204
205 What:           /sys/fs/f2fs/<disk>/extension_list
206 Date:           Feburary 2018
207 Contact:        "Chao Yu" <yuchao0@huawei.com>
208 Description:
209                  Used to control configure extension list:
210                  - Query: cat /sys/fs/f2fs/<disk>/extension_list
211                  - Add: echo '[h/c]extension' > /sys/fs/f2fs/<disk>/extension_list
212                  - Del: echo '[h/c]!extension' > /sys/fs/f2fs/<disk>/extension_list
213                  - [h] means add/del hot file extension
214                  - [c] means add/del cold file extension