Merge tag 'ceph-for-4.20-rc1' of git://github.com/ceph/ceph-client
[sfrench/cifs-2.6.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 for all paths other than
125                  discard and gc path.
126
127 What:           /sys/fs/f2fs/<disk>/discard_idle_interval
128 Date:           September 2018
129 Contact:        "Chao Yu" <yuchao0@huawei.com>
130 Contact:        "Sahitya Tummala" <stummala@codeaurora.org>
131 Description:
132                  Controls the idle timing for discard path.
133
134 What:           /sys/fs/f2fs/<disk>/gc_idle_interval
135 Date:           September 2018
136 Contact:        "Chao Yu" <yuchao0@huawei.com>
137 Contact:        "Sahitya Tummala" <stummala@codeaurora.org>
138 Description:
139                  Controls the idle timing for gc path.
140
141 What:           /sys/fs/f2fs/<disk>/iostat_enable
142 Date:           August 2017
143 Contact:        "Chao Yu" <yuchao0@huawei.com>
144 Description:
145                  Controls to enable/disable IO stat.
146
147 What:           /sys/fs/f2fs/<disk>/ra_nid_pages
148 Date:           October 2015
149 Contact:        "Chao Yu" <chao2.yu@samsung.com>
150 Description:
151                  Controls the count of nid pages to be readaheaded.
152
153 What:           /sys/fs/f2fs/<disk>/dirty_nats_ratio
154 Date:           January 2016
155 Contact:        "Chao Yu" <chao2.yu@samsung.com>
156 Description:
157                  Controls dirty nat entries ratio threshold, if current
158                  ratio exceeds configured threshold, checkpoint will
159                  be triggered for flushing dirty nat entries.
160
161 What:           /sys/fs/f2fs/<disk>/lifetime_write_kbytes
162 Date:           January 2016
163 Contact:        "Shuoran Liu" <liushuoran@huawei.com>
164 Description:
165                  Shows total written kbytes issued to disk.
166
167 What:           /sys/fs/f2fs/<disk>/features
168 Date:           July 2017
169 Contact:        "Jaegeuk Kim" <jaegeuk@kernel.org>
170 Description:
171                  Shows all enabled features in current device.
172
173 What:           /sys/fs/f2fs/<disk>/inject_rate
174 Date:           May 2016
175 Contact:        "Sheng Yong" <shengyong1@huawei.com>
176 Description:
177                  Controls the injection rate.
178
179 What:           /sys/fs/f2fs/<disk>/inject_type
180 Date:           May 2016
181 Contact:        "Sheng Yong" <shengyong1@huawei.com>
182 Description:
183                  Controls the injection type.
184
185 What:           /sys/fs/f2fs/<disk>/reserved_blocks
186 Date:           June 2017
187 Contact:        "Chao Yu" <yuchao0@huawei.com>
188 Description:
189                  Controls target reserved blocks in system, the threshold
190                  is soft, it could exceed current available user space.
191
192 What:           /sys/fs/f2fs/<disk>/current_reserved_blocks
193 Date:           October 2017
194 Contact:        "Yunlong Song" <yunlong.song@huawei.com>
195 Contact:        "Chao Yu" <yuchao0@huawei.com>
196 Description:
197                  Shows current reserved blocks in system, it may be temporarily
198                  smaller than target_reserved_blocks, but will gradually
199                  increase to target_reserved_blocks when more free blocks are
200                  freed by user later.
201
202 What:           /sys/fs/f2fs/<disk>/gc_urgent
203 Date:           August 2017
204 Contact:        "Jaegeuk Kim" <jaegeuk@kernel.org>
205 Description:
206                  Do background GC agressively
207
208 What:           /sys/fs/f2fs/<disk>/gc_urgent_sleep_time
209 Date:           August 2017
210 Contact:        "Jaegeuk Kim" <jaegeuk@kernel.org>
211 Description:
212                  Controls sleep time of GC urgent mode
213
214 What:           /sys/fs/f2fs/<disk>/readdir_ra
215 Date:           November 2017
216 Contact:        "Sheng Yong" <shengyong1@huawei.com>
217 Description:
218                  Controls readahead inode block in readdir.
219
220 What:           /sys/fs/f2fs/<disk>/extension_list
221 Date:           Feburary 2018
222 Contact:        "Chao Yu" <yuchao0@huawei.com>
223 Description:
224                  Used to control configure extension list:
225                  - Query: cat /sys/fs/f2fs/<disk>/extension_list
226                  - Add: echo '[h/c]extension' > /sys/fs/f2fs/<disk>/extension_list
227                  - Del: echo '[h/c]!extension' > /sys/fs/f2fs/<disk>/extension_list
228                  - [h] means add/del hot file extension
229                  - [c] means add/del cold file extension