Merge tag 'for-4.18-part2-tag' of git://git.kernel.org/pub/scm/linux/kernel/git/kdave...
[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_hot_blocks
55 Date:           March 2017
56 Contact:        "Jaegeuk Kim" <jaegeuk@kernel.org>
57 Description:
58                  Controls the dirty page count condition for redefining hot data.
59
60 What:           /sys/fs/f2fs/<disk>/min_ssr_sections
61 Date:           October 2017
62 Contact:        "Chao Yu" <yuchao0@huawei.com>
63 Description:
64                  Controls the fee section threshold to trigger SSR allocation.
65
66 What:           /sys/fs/f2fs/<disk>/max_small_discards
67 Date:           November 2013
68 Contact:        "Jaegeuk Kim" <jaegeuk.kim@samsung.com>
69 Description:
70                  Controls the issue rate of small discard commands.
71
72 What:          /sys/fs/f2fs/<disk>/discard_granularity
73 Date:          July 2017
74 Contact:       "Chao Yu" <yuchao0@huawei.com>
75 Description:
76                 Controls discard granularity of inner discard thread, inner thread
77                 will not issue discards with size that is smaller than granularity.
78                 The unit size is one block, now only support configuring in range
79                 of [1, 512].
80
81 What:           /sys/fs/f2fs/<disk>/max_victim_search
82 Date:           January 2014
83 Contact:        "Jaegeuk Kim" <jaegeuk.kim@samsung.com>
84 Description:
85                  Controls the number of trials to find a victim segment.
86
87 What:           /sys/fs/f2fs/<disk>/dir_level
88 Date:           March 2014
89 Contact:        "Jaegeuk Kim" <jaegeuk.kim@samsung.com>
90 Description:
91                  Controls the directory level for large directory.
92
93 What:           /sys/fs/f2fs/<disk>/ram_thresh
94 Date:           March 2014
95 Contact:        "Jaegeuk Kim" <jaegeuk.kim@samsung.com>
96 Description:
97                  Controls the memory footprint used by f2fs.
98
99 What:           /sys/fs/f2fs/<disk>/batched_trim_sections
100 Date:           February 2015
101 Contact:        "Jaegeuk Kim" <jaegeuk@kernel.org>
102 Description:
103                  Controls the trimming rate in batch mode.
104                  <deprecated>
105
106 What:           /sys/fs/f2fs/<disk>/cp_interval
107 Date:           October 2015
108 Contact:        "Jaegeuk Kim" <jaegeuk@kernel.org>
109 Description:
110                  Controls the checkpoint timing.
111
112 What:           /sys/fs/f2fs/<disk>/idle_interval
113 Date:           January 2016
114 Contact:        "Jaegeuk Kim" <jaegeuk@kernel.org>
115 Description:
116                  Controls the idle timing.
117
118 What:           /sys/fs/f2fs/<disk>/iostat_enable
119 Date:           August 2017
120 Contact:        "Chao Yu" <yuchao0@huawei.com>
121 Description:
122                  Controls to enable/disable IO stat.
123
124 What:           /sys/fs/f2fs/<disk>/ra_nid_pages
125 Date:           October 2015
126 Contact:        "Chao Yu" <chao2.yu@samsung.com>
127 Description:
128                  Controls the count of nid pages to be readaheaded.
129
130 What:           /sys/fs/f2fs/<disk>/dirty_nats_ratio
131 Date:           January 2016
132 Contact:        "Chao Yu" <chao2.yu@samsung.com>
133 Description:
134                  Controls dirty nat entries ratio threshold, if current
135                  ratio exceeds configured threshold, checkpoint will
136                  be triggered for flushing dirty nat entries.
137
138 What:           /sys/fs/f2fs/<disk>/lifetime_write_kbytes
139 Date:           January 2016
140 Contact:        "Shuoran Liu" <liushuoran@huawei.com>
141 Description:
142                  Shows total written kbytes issued to disk.
143
144 What:           /sys/fs/f2fs/<disk>/features
145 Date:           July 2017
146 Contact:        "Jaegeuk Kim" <jaegeuk@kernel.org>
147 Description:
148                  Shows all enabled features in current device.
149
150 What:           /sys/fs/f2fs/<disk>/inject_rate
151 Date:           May 2016
152 Contact:        "Sheng Yong" <shengyong1@huawei.com>
153 Description:
154                  Controls the injection rate.
155
156 What:           /sys/fs/f2fs/<disk>/inject_type
157 Date:           May 2016
158 Contact:        "Sheng Yong" <shengyong1@huawei.com>
159 Description:
160                  Controls the injection type.
161
162 What:           /sys/fs/f2fs/<disk>/reserved_blocks
163 Date:           June 2017
164 Contact:        "Chao Yu" <yuchao0@huawei.com>
165 Description:
166                  Controls target reserved blocks in system, the threshold
167                  is soft, it could exceed current available user space.
168
169 What:           /sys/fs/f2fs/<disk>/current_reserved_blocks
170 Date:           October 2017
171 Contact:        "Yunlong Song" <yunlong.song@huawei.com>
172 Contact:        "Chao Yu" <yuchao0@huawei.com>
173 Description:
174                  Shows current reserved blocks in system, it may be temporarily
175                  smaller than target_reserved_blocks, but will gradually
176                  increase to target_reserved_blocks when more free blocks are
177                  freed by user later.
178
179 What:           /sys/fs/f2fs/<disk>/gc_urgent
180 Date:           August 2017
181 Contact:        "Jaegeuk Kim" <jaegeuk@kernel.org>
182 Description:
183                  Do background GC agressively
184
185 What:           /sys/fs/f2fs/<disk>/gc_urgent_sleep_time
186 Date:           August 2017
187 Contact:        "Jaegeuk Kim" <jaegeuk@kernel.org>
188 Description:
189                  Controls sleep time of GC urgent mode
190
191 What:           /sys/fs/f2fs/<disk>/readdir_ra
192 Date:           November 2017
193 Contact:        "Sheng Yong" <shengyong1@huawei.com>
194 Description:
195                  Controls readahead inode block in readdir.
196
197 What:           /sys/fs/f2fs/<disk>/extension_list
198 Date:           Feburary 2018
199 Contact:        "Chao Yu" <yuchao0@huawei.com>
200 Description:
201                  Used to control configure extension list:
202                  - Query: cat /sys/fs/f2fs/<disk>/extension_list
203                  - Add: echo '[h/c]extension' > /sys/fs/f2fs/<disk>/extension_list
204                  - Del: echo '[h/c]!extension' > /sys/fs/f2fs/<disk>/extension_list
205                  - [h] means add/del hot file extension
206                  - [c] means add/del cold file extension