1 what: /sys/kernel/mm/damon/ 1 what: /sys/kernel/mm/damon/
2 Date: Mar 2022 2 Date: Mar 2022
3 Contact: SeongJae Park <sj@kernel.org> 3 Contact: SeongJae Park <sj@kernel.org>
4 Description: Interface for Data Access MONi 4 Description: Interface for Data Access MONitoring (DAMON). Contains files
5 for controlling DAMON. For mo 5 for controlling DAMON. For more details on DAMON itself,
6 please refer to Documentation/ 6 please refer to Documentation/admin-guide/mm/damon/index.rst.
7 7
8 What: /sys/kernel/mm/damon/admin/ 8 What: /sys/kernel/mm/damon/admin/
9 Date: Mar 2022 9 Date: Mar 2022
10 Contact: SeongJae Park <sj@kernel.org> 10 Contact: SeongJae Park <sj@kernel.org>
11 Description: Interface for privileged users 11 Description: Interface for privileged users of DAMON. Contains files for
12 controlling DAMON that aimed t 12 controlling DAMON that aimed to be used by privileged users.
13 13
14 What: /sys/kernel/mm/damon/admin/kda 14 What: /sys/kernel/mm/damon/admin/kdamonds/nr_kdamonds
15 Date: Mar 2022 15 Date: Mar 2022
16 Contact: SeongJae Park <sj@kernel.org> 16 Contact: SeongJae Park <sj@kernel.org>
17 Description: Writing a number 'N' to this f 17 Description: Writing a number 'N' to this file creates the number of
18 directories for controlling ea 18 directories for controlling each DAMON worker thread (kdamond)
19 named '0' to 'N-1' under the k 19 named '0' to 'N-1' under the kdamonds/ directory.
20 20
21 What: /sys/kernel/mm/damon/admin/kda 21 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/state
22 Date: Mar 2022 22 Date: Mar 2022
23 Contact: SeongJae Park <sj@kernel.org> 23 Contact: SeongJae Park <sj@kernel.org>
24 Description: Writing 'on' or 'off' to this 24 Description: Writing 'on' or 'off' to this file makes the kdamond starts or
25 stops, respectively. Reading 25 stops, respectively. Reading the file returns the keywords
26 based on the current status. 26 based on the current status. Writing 'commit' to this file
27 makes the kdamond reads the us 27 makes the kdamond reads the user inputs in the sysfs files
28 except 'state' again. Writing 28 except 'state' again. Writing 'commit_schemes_quota_goals' to
29 this file makes the kdamond re 29 this file makes the kdamond reads the quota goal files again.
30 Writing 'update_schemes_stats' 30 Writing 'update_schemes_stats' to the file updates contents of
31 schemes stats files of the kda 31 schemes stats files of the kdamond. Writing
32 'update_schemes_tried_regions' 32 'update_schemes_tried_regions' to the file updates contents of
33 'tried_regions' directory of e 33 'tried_regions' directory of every scheme directory of this
34 kdamond. Writing 'update_sche 34 kdamond. Writing 'update_schemes_tried_bytes' to the file
35 updates only '.../tried_region 35 updates only '.../tried_regions/total_bytes' files of this
36 kdamond. Writing 'clear_schem 36 kdamond. Writing 'clear_schemes_tried_regions' to the file
37 removes contents of the 'tried 37 removes contents of the 'tried_regions' directory. Writing
38 'update_schemes_effective_quot 38 'update_schemes_effective_quotas' to the file updates
39 '.../quotas/effective_bytes' f 39 '.../quotas/effective_bytes' files of this kdamond.
40 40
41 What: /sys/kernel/mm/damon/admin/kda 41 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/pid
42 Date: Mar 2022 42 Date: Mar 2022
43 Contact: SeongJae Park <sj@kernel.org> 43 Contact: SeongJae Park <sj@kernel.org>
44 Description: Reading this file returns the 44 Description: Reading this file returns the pid of the kdamond if it is
45 running. 45 running.
46 46
47 What: /sys/kernel/mm/damon/admin/kda 47 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/nr_contexts
48 Date: Mar 2022 48 Date: Mar 2022
49 Contact: SeongJae Park <sj@kernel.org> 49 Contact: SeongJae Park <sj@kernel.org>
50 Description: Writing a number 'N' to this f 50 Description: Writing a number 'N' to this file creates the number of
51 directories for controlling ea 51 directories for controlling each DAMON context named '0' to
52 'N-1' under the contexts/ dire 52 'N-1' under the contexts/ directory.
53 53
54 What: /sys/kernel/mm/damon/admin/kda 54 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/avail_operations
55 Date: Apr 2022 55 Date: Apr 2022
56 Contact: SeongJae Park <sj@kernel.org> 56 Contact: SeongJae Park <sj@kernel.org>
57 Description: Reading this file returns the 57 Description: Reading this file returns the available monitoring operations
58 sets on the currently running 58 sets on the currently running kernel.
59 59
60 What: /sys/kernel/mm/damon/admin/kda 60 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/operations
61 Date: Mar 2022 61 Date: Mar 2022
62 Contact: SeongJae Park <sj@kernel.org> 62 Contact: SeongJae Park <sj@kernel.org>
63 Description: Writing a keyword for a monito 63 Description: Writing a keyword for a monitoring operations set ('vaddr' for
64 virtual address spaces monitor 64 virtual address spaces monitoring, 'fvaddr' for fixed virtual
65 address ranges monitoring, and 65 address ranges monitoring, and 'paddr' for the physical address
66 space monitoring) to this file 66 space monitoring) to this file makes the context to use the
67 operations set. Reading the f 67 operations set. Reading the file returns the keyword for the
68 operations set the context is 68 operations set the context is set to use.
69 69
70 Note that only the operations 70 Note that only the operations sets that listed in
71 'avail_operations' file are va 71 'avail_operations' file are valid inputs.
72 72
73 What: /sys/kernel/mm/damon/admin/kda 73 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/intervals/sample_us
74 Date: Mar 2022 74 Date: Mar 2022
75 Contact: SeongJae Park <sj@kernel.org> 75 Contact: SeongJae Park <sj@kernel.org>
76 Description: Writing a value to this file s 76 Description: Writing a value to this file sets the sampling interval of the
77 DAMON context in microseconds 77 DAMON context in microseconds as the value. Reading this file
78 returns the value. 78 returns the value.
79 79
80 What: /sys/kernel/mm/damon/admin/kda 80 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/intervals/aggr_us
81 Date: Mar 2022 81 Date: Mar 2022
82 Contact: SeongJae Park <sj@kernel.org> 82 Contact: SeongJae Park <sj@kernel.org>
83 Description: Writing a value to this file s 83 Description: Writing a value to this file sets the aggregation interval of
84 the DAMON context in microseco 84 the DAMON context in microseconds as the value. Reading this
85 file returns the value. 85 file returns the value.
86 86
87 What: /sys/kernel/mm/damon/admin/kda 87 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/intervals/update_us
88 Date: Mar 2022 88 Date: Mar 2022
89 Contact: SeongJae Park <sj@kernel.org> 89 Contact: SeongJae Park <sj@kernel.org>
90 Description: Writing a value to this file s 90 Description: Writing a value to this file sets the update interval of the
91 DAMON context in microseconds 91 DAMON context in microseconds as the value. Reading this file
92 returns the value. 92 returns the value.
93 93
94 What: /sys/kernel/mm/damon/admin/kda 94 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/nr_regions/min
95 95
96 WDate: Mar 2022 96 WDate: Mar 2022
97 Contact: SeongJae Park <sj@kernel.org> 97 Contact: SeongJae Park <sj@kernel.org>
98 Description: Writing a value to this file s 98 Description: Writing a value to this file sets the minimum number of
99 monitoring regions of the DAMO 99 monitoring regions of the DAMON context as the value. Reading
100 this file returns the value. 100 this file returns the value.
101 101
102 What: /sys/kernel/mm/damon/admin/kda 102 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/nr_regions/max
103 Date: Mar 2022 103 Date: Mar 2022
104 Contact: SeongJae Park <sj@kernel.org> 104 Contact: SeongJae Park <sj@kernel.org>
105 Description: Writing a value to this file s 105 Description: Writing a value to this file sets the maximum number of
106 monitoring regions of the DAMO 106 monitoring regions of the DAMON context as the value. Reading
107 this file returns the value. 107 this file returns the value.
108 108
109 What: /sys/kernel/mm/damon/admin/kda 109 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/targets/nr_targets
110 Date: Mar 2022 110 Date: Mar 2022
111 Contact: SeongJae Park <sj@kernel.org> 111 Contact: SeongJae Park <sj@kernel.org>
112 Description: Writing a number 'N' to this f 112 Description: Writing a number 'N' to this file creates the number of
113 directories for controlling ea 113 directories for controlling each DAMON target of the context
114 named '0' to 'N-1' under the c 114 named '0' to 'N-1' under the contexts/ directory.
115 115
116 What: /sys/kernel/mm/damon/admin/kda 116 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/targets/<T>/pid_target
117 Date: Mar 2022 117 Date: Mar 2022
118 Contact: SeongJae Park <sj@kernel.org> 118 Contact: SeongJae Park <sj@kernel.org>
119 Description: Writing to and reading from th 119 Description: Writing to and reading from this file sets and gets the pid of
120 the target process if the cont 120 the target process if the context is for virtual address spaces
121 monitoring, respectively. 121 monitoring, respectively.
122 122
123 What: /sys/kernel/mm/damon/admin/kda 123 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/targets/<T>/regions/nr_regions
124 Date: Mar 2022 124 Date: Mar 2022
125 Contact: SeongJae Park <sj@kernel.org> 125 Contact: SeongJae Park <sj@kernel.org>
126 Description: Writing a number 'N' to this f 126 Description: Writing a number 'N' to this file creates the number of
127 directories for setting each D 127 directories for setting each DAMON target memory region of the
128 context named '0' to 'N-1' und 128 context named '0' to 'N-1' under the regions/ directory. In
129 case of the virtual address sp 129 case of the virtual address space monitoring, DAMON
130 automatically sets the target 130 automatically sets the target memory region based on the target
131 processes' mappings. 131 processes' mappings.
132 132
133 What: /sys/kernel/mm/damon/admin/kda 133 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/targets/<T>/regions/<R>/start
134 Date: Mar 2022 134 Date: Mar 2022
135 Contact: SeongJae Park <sj@kernel.org> 135 Contact: SeongJae Park <sj@kernel.org>
136 Description: Writing to and reading from th 136 Description: Writing to and reading from this file sets and gets the start
137 address of the monitoring regi 137 address of the monitoring region.
138 138
139 What: /sys/kernel/mm/damon/admin/kda 139 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/targets/<T>/regions/<R>/end
140 Date: Mar 2022 140 Date: Mar 2022
141 Contact: SeongJae Park <sj@kernel.org> 141 Contact: SeongJae Park <sj@kernel.org>
142 Description: Writing to and reading from th 142 Description: Writing to and reading from this file sets and gets the end
143 address of the monitoring regi 143 address of the monitoring region.
144 144
145 What: /sys/kernel/mm/damon/admin/kda 145 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/nr_schemes
146 Date: Mar 2022 146 Date: Mar 2022
147 Contact: SeongJae Park <sj@kernel.org> 147 Contact: SeongJae Park <sj@kernel.org>
148 Description: Writing a number 'N' to this f 148 Description: Writing a number 'N' to this file creates the number of
149 directories for controlling ea 149 directories for controlling each DAMON-based operation scheme
150 of the context named '0' to 'N 150 of the context named '0' to 'N-1' under the schemes/ directory.
151 151
152 What: /sys/kernel/mm/damon/admin/kda 152 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/action
153 Date: Mar 2022 153 Date: Mar 2022
154 Contact: SeongJae Park <sj@kernel.org> 154 Contact: SeongJae Park <sj@kernel.org>
155 Description: Writing to and reading from th 155 Description: Writing to and reading from this file sets and gets the action
156 of the scheme. 156 of the scheme.
157 157
158 What: /sys/kernel/mm/damon/admin/kda <<
159 Date: Jun 2024 <<
160 Contact: SeongJae Park <sj@kernel.org> <<
161 Description: Action's target NUMA node id. <<
162 actions. <<
163 <<
164 What: /sys/kernel/mm/damon/admin/kda 158 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/apply_interval_us
165 Date: Sep 2023 159 Date: Sep 2023
166 Contact: SeongJae Park <sj@kernel.org> 160 Contact: SeongJae Park <sj@kernel.org>
167 Description: Writing a value to this file s 161 Description: Writing a value to this file sets the action apply interval of
168 the scheme in microseconds. R 162 the scheme in microseconds. Reading this file returns the
169 value. 163 value.
170 164
171 What: /sys/kernel/mm/damon/admin/kda 165 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/access_pattern/sz/min
172 Date: Mar 2022 166 Date: Mar 2022
173 Contact: SeongJae Park <sj@kernel.org> 167 Contact: SeongJae Park <sj@kernel.org>
174 Description: Writing to and reading from th 168 Description: Writing to and reading from this file sets and gets the minimum
175 size of the scheme's target re 169 size of the scheme's target regions in bytes.
176 170
177 What: /sys/kernel/mm/damon/admin/kda 171 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/access_pattern/sz/max
178 Date: Mar 2022 172 Date: Mar 2022
179 Contact: SeongJae Park <sj@kernel.org> 173 Contact: SeongJae Park <sj@kernel.org>
180 Description: Writing to and reading from th 174 Description: Writing to and reading from this file sets and gets the maximum
181 size of the scheme's target re 175 size of the scheme's target regions in bytes.
182 176
183 What: /sys/kernel/mm/damon/admin/kda 177 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/access_pattern/nr_accesses/min
184 Date: Mar 2022 178 Date: Mar 2022
185 Contact: SeongJae Park <sj@kernel.org> 179 Contact: SeongJae Park <sj@kernel.org>
186 Description: Writing to and reading from th 180 Description: Writing to and reading from this file sets and gets the manimum
187 'nr_accesses' of the scheme's 181 'nr_accesses' of the scheme's target regions.
188 182
189 What: /sys/kernel/mm/damon/admin/kda 183 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/access_pattern/nr_accesses/max
190 Date: Mar 2022 184 Date: Mar 2022
191 Contact: SeongJae Park <sj@kernel.org> 185 Contact: SeongJae Park <sj@kernel.org>
192 Description: Writing to and reading from th 186 Description: Writing to and reading from this file sets and gets the maximum
193 'nr_accesses' of the scheme's 187 'nr_accesses' of the scheme's target regions.
194 188
195 What: /sys/kernel/mm/damon/admin/kda 189 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/access_pattern/age/min
196 Date: Mar 2022 190 Date: Mar 2022
197 Contact: SeongJae Park <sj@kernel.org> 191 Contact: SeongJae Park <sj@kernel.org>
198 Description: Writing to and reading from th 192 Description: Writing to and reading from this file sets and gets the minimum
199 'age' of the scheme's target r 193 'age' of the scheme's target regions.
200 194
201 What: /sys/kernel/mm/damon/admin/kda 195 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/access_pattern/age/max
202 Date: Mar 2022 196 Date: Mar 2022
203 Contact: SeongJae Park <sj@kernel.org> 197 Contact: SeongJae Park <sj@kernel.org>
204 Description: Writing to and reading from th 198 Description: Writing to and reading from this file sets and gets the maximum
205 'age' of the scheme's target r 199 'age' of the scheme's target regions.
206 200
207 What: /sys/kernel/mm/damon/admin/kda 201 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/ms
208 Date: Mar 2022 202 Date: Mar 2022
209 Contact: SeongJae Park <sj@kernel.org> 203 Contact: SeongJae Park <sj@kernel.org>
210 Description: Writing to and reading from th 204 Description: Writing to and reading from this file sets and gets the time
211 quota of the scheme in millise 205 quota of the scheme in milliseconds.
212 206
213 What: /sys/kernel/mm/damon/admin/kda 207 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/bytes
214 Date: Mar 2022 208 Date: Mar 2022
215 Contact: SeongJae Park <sj@kernel.org> 209 Contact: SeongJae Park <sj@kernel.org>
216 Description: Writing to and reading from th 210 Description: Writing to and reading from this file sets and gets the size
217 quota of the scheme in bytes. 211 quota of the scheme in bytes.
218 212
219 What: /sys/kernel/mm/damon/admin/kda 213 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/effective_bytes
220 Date: Feb 2024 214 Date: Feb 2024
221 Contact: SeongJae Park <sj@kernel.org> 215 Contact: SeongJae Park <sj@kernel.org>
222 Description: Reading from this file gets th 216 Description: Reading from this file gets the effective size quota of the
223 scheme in bytes, which adjuste 217 scheme in bytes, which adjusted for the time quota and goals.
224 218
225 What: /sys/kernel/mm/damon/admin/kda 219 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/reset_interval_ms
226 Date: Mar 2022 220 Date: Mar 2022
227 Contact: SeongJae Park <sj@kernel.org> 221 Contact: SeongJae Park <sj@kernel.org>
228 Description: Writing to and reading from th 222 Description: Writing to and reading from this file sets and gets the quotas
229 charge reset interval of the s 223 charge reset interval of the scheme in milliseconds.
230 224
231 What: /sys/kernel/mm/damon/admin/kda 225 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/goals/nr_goals
232 Date: Nov 2023 226 Date: Nov 2023
233 Contact: SeongJae Park <sj@kernel.org> 227 Contact: SeongJae Park <sj@kernel.org>
234 Description: Writing a number 'N' to this f 228 Description: Writing a number 'N' to this file creates the number of
235 directories for setting automa 229 directories for setting automatic tuning of the scheme's
236 aggressiveness named '0' to 'N 230 aggressiveness named '0' to 'N-1' under the goals/ directory.
237 231
238 What: /sys/kernel/mm/damon/admin/kda 232 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/goals/<G>/target_metric
239 Date: Feb 2024 233 Date: Feb 2024
240 Contact: SeongJae Park <sj@kernel.org> 234 Contact: SeongJae Park <sj@kernel.org>
241 Description: Writing to and reading from th 235 Description: Writing to and reading from this file sets and gets the quota
242 auto-tuning goal metric. 236 auto-tuning goal metric.
243 237
244 What: /sys/kernel/mm/damon/admin/kda 238 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/goals/<G>/target_value
245 Date: Nov 2023 239 Date: Nov 2023
246 Contact: SeongJae Park <sj@kernel.org> 240 Contact: SeongJae Park <sj@kernel.org>
247 Description: Writing to and reading from th 241 Description: Writing to and reading from this file sets and gets the target
248 value of the goal metric. 242 value of the goal metric.
249 243
250 What: /sys/kernel/mm/damon/admin/kda 244 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/goals/<G>/current_value
251 Date: Nov 2023 245 Date: Nov 2023
252 Contact: SeongJae Park <sj@kernel.org> 246 Contact: SeongJae Park <sj@kernel.org>
253 Description: Writing to and reading from th 247 Description: Writing to and reading from this file sets and gets the current
254 value of the goal metric. 248 value of the goal metric.
255 249
256 What: /sys/kernel/mm/damon/admin/kda 250 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/weights/sz_permil
257 Date: Mar 2022 251 Date: Mar 2022
258 Contact: SeongJae Park <sj@kernel.org> 252 Contact: SeongJae Park <sj@kernel.org>
259 Description: Writing to and reading from th 253 Description: Writing to and reading from this file sets and gets the
260 under-quota limit regions prio 254 under-quota limit regions prioritization weight for 'size' in
261 permil. 255 permil.
262 256
263 What: /sys/kernel/mm/damon/admin/kda 257 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/weights/nr_accesses_permil
264 Date: Mar 2022 258 Date: Mar 2022
265 Contact: SeongJae Park <sj@kernel.org> 259 Contact: SeongJae Park <sj@kernel.org>
266 Description: Writing to and reading from th 260 Description: Writing to and reading from this file sets and gets the
267 under-quota limit regions prio 261 under-quota limit regions prioritization weight for
268 'nr_accesses' in permil. 262 'nr_accesses' in permil.
269 263
270 What: /sys/kernel/mm/damon/admin/kda 264 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/weights/age_permil
271 Date: Mar 2022 265 Date: Mar 2022
272 Contact: SeongJae Park <sj@kernel.org> 266 Contact: SeongJae Park <sj@kernel.org>
273 Description: Writing to and reading from th 267 Description: Writing to and reading from this file sets and gets the
274 under-quota limit regions prio 268 under-quota limit regions prioritization weight for 'age' in
275 permil. 269 permil.
276 270
277 What: /sys/kernel/mm/damon/admin/kda 271 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/watermarks/metric
278 Date: Mar 2022 272 Date: Mar 2022
279 Contact: SeongJae Park <sj@kernel.org> 273 Contact: SeongJae Park <sj@kernel.org>
280 Description: Writing to and reading from th 274 Description: Writing to and reading from this file sets and gets the metric
281 of the watermarks for the sche 275 of the watermarks for the scheme. The writable/readable
282 keywords for this file are 'no 276 keywords for this file are 'none' for disabling the watermarks
283 feature, or 'free_mem_rate' fo 277 feature, or 'free_mem_rate' for the system's global free memory
284 rate in permil. 278 rate in permil.
285 279
286 What: /sys/kernel/mm/damon/admin/kda 280 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/watermarks/interval_us
287 Date: Mar 2022 281 Date: Mar 2022
288 Contact: SeongJae Park <sj@kernel.org> 282 Contact: SeongJae Park <sj@kernel.org>
289 Description: Writing to and reading from th 283 Description: Writing to and reading from this file sets and gets the metric
290 check interval of the watermar 284 check interval of the watermarks for the scheme in
291 microseconds. 285 microseconds.
292 286
293 What: /sys/kernel/mm/damon/admin/kda 287 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/watermarks/high
294 Date: Mar 2022 288 Date: Mar 2022
295 Contact: SeongJae Park <sj@kernel.org> 289 Contact: SeongJae Park <sj@kernel.org>
296 Description: Writing to and reading from th 290 Description: Writing to and reading from this file sets and gets the high
297 watermark of the scheme in per 291 watermark of the scheme in permil.
298 292
299 What: /sys/kernel/mm/damon/admin/kda 293 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/watermarks/mid
300 Date: Mar 2022 294 Date: Mar 2022
301 Contact: SeongJae Park <sj@kernel.org> 295 Contact: SeongJae Park <sj@kernel.org>
302 Description: Writing to and reading from th 296 Description: Writing to and reading from this file sets and gets the mid
303 watermark of the scheme in per 297 watermark of the scheme in permil.
304 298
305 What: /sys/kernel/mm/damon/admin/kda 299 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/watermarks/low
306 Date: Mar 2022 300 Date: Mar 2022
307 Contact: SeongJae Park <sj@kernel.org> 301 Contact: SeongJae Park <sj@kernel.org>
308 Description: Writing to and reading from th 302 Description: Writing to and reading from this file sets and gets the low
309 watermark of the scheme in per 303 watermark of the scheme in permil.
310 304
311 What: /sys/kernel/mm/damon/admin/kda 305 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/nr_filters
312 Date: Dec 2022 306 Date: Dec 2022
313 Contact: SeongJae Park <sj@kernel.org> 307 Contact: SeongJae Park <sj@kernel.org>
314 Description: Writing a number 'N' to this f 308 Description: Writing a number 'N' to this file creates the number of
315 directories for setting filter 309 directories for setting filters of the scheme named '0' to
316 'N-1' under the filters/ direc 310 'N-1' under the filters/ directory.
317 311
318 What: /sys/kernel/mm/damon/admin/kda 312 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/<F>/type
319 Date: Dec 2022 313 Date: Dec 2022
320 Contact: SeongJae Park <sj@kernel.org> 314 Contact: SeongJae Park <sj@kernel.org>
321 Description: Writing to and reading from th 315 Description: Writing to and reading from this file sets and gets the type of
322 the memory of the interest. ' 316 the memory of the interest. 'anon' for anonymous pages,
323 'memcg' for specific memory cg 317 'memcg' for specific memory cgroup, 'young' for young pages,
324 'addr' for address range (an o 318 'addr' for address range (an open-ended interval), or 'target'
325 for DAMON monitoring target ca 319 for DAMON monitoring target can be written and read.
326 320
327 What: /sys/kernel/mm/damon/admin/kda 321 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/<F>/memcg_path
328 Date: Dec 2022 322 Date: Dec 2022
329 Contact: SeongJae Park <sj@kernel.org> 323 Contact: SeongJae Park <sj@kernel.org>
330 Description: If 'memcg' is written to the ' 324 Description: If 'memcg' is written to the 'type' file, writing to and
331 reading from this file sets an 325 reading from this file sets and gets the path to the memory
332 cgroup of the interest. 326 cgroup of the interest.
333 327
334 What: /sys/kernel/mm/damon/admin/kda 328 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/<F>/addr_start
335 Date: Jul 2023 329 Date: Jul 2023
336 Contact: SeongJae Park <sj@kernel.org> 330 Contact: SeongJae Park <sj@kernel.org>
337 Description: If 'addr' is written to the 't 331 Description: If 'addr' is written to the 'type' file, writing to or reading
338 from this file sets or gets th 332 from this file sets or gets the start address of the address
339 range for the filter. 333 range for the filter.
340 334
341 What: /sys/kernel/mm/damon/admin/kda 335 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/<F>/addr_end
342 Date: Jul 2023 336 Date: Jul 2023
343 Contact: SeongJae Park <sj@kernel.org> 337 Contact: SeongJae Park <sj@kernel.org>
344 Description: If 'addr' is written to the 't 338 Description: If 'addr' is written to the 'type' file, writing to or reading
345 from this file sets or gets th 339 from this file sets or gets the end address of the address
346 range for the filter. 340 range for the filter.
347 341
348 What: /sys/kernel/mm/damon/admin/kda 342 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/<F>/target_idx
349 Date: Dec 2022 343 Date: Dec 2022
350 Contact: SeongJae Park <sj@kernel.org> 344 Contact: SeongJae Park <sj@kernel.org>
351 Description: If 'target' is written to the 345 Description: If 'target' is written to the 'type' file, writing to or
352 reading from this file sets or 346 reading from this file sets or gets the index of the DAMON
353 monitoring target of the inter 347 monitoring target of the interest.
354 348
355 What: /sys/kernel/mm/damon/admin/kda 349 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/<F>/matching
356 Date: Dec 2022 350 Date: Dec 2022
357 Contact: SeongJae Park <sj@kernel.org> 351 Contact: SeongJae Park <sj@kernel.org>
358 Description: Writing 'Y' or 'N' to this fil 352 Description: Writing 'Y' or 'N' to this file sets whether to filter out
359 pages that do or do not match 353 pages that do or do not match to the 'type' and 'memcg_path',
360 respectively. Filter out mean 354 respectively. Filter out means the action of the scheme will
361 not be applied to. 355 not be applied to.
362 356
363 What: /sys/kernel/mm/damon/admin/kda 357 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/stats/nr_tried
364 Date: Mar 2022 358 Date: Mar 2022
365 Contact: SeongJae Park <sj@kernel.org> 359 Contact: SeongJae Park <sj@kernel.org>
366 Description: Reading this file returns the 360 Description: Reading this file returns the number of regions that the action
367 of the scheme has tried to be 361 of the scheme has tried to be applied.
368 362
369 What: /sys/kernel/mm/damon/admin/kda 363 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/stats/sz_tried
370 Date: Mar 2022 364 Date: Mar 2022
371 Contact: SeongJae Park <sj@kernel.org> 365 Contact: SeongJae Park <sj@kernel.org>
372 Description: Reading this file returns the 366 Description: Reading this file returns the total size of regions that the
373 action of the scheme has tried 367 action of the scheme has tried to be applied in bytes.
374 368
375 What: /sys/kernel/mm/damon/admin/kda 369 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/stats/nr_applied
376 Date: Mar 2022 370 Date: Mar 2022
377 Contact: SeongJae Park <sj@kernel.org> 371 Contact: SeongJae Park <sj@kernel.org>
378 Description: Reading this file returns the 372 Description: Reading this file returns the number of regions that the action
379 of the scheme has successfully 373 of the scheme has successfully applied.
380 374
381 What: /sys/kernel/mm/damon/admin/kda 375 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/stats/sz_applied
382 Date: Mar 2022 376 Date: Mar 2022
383 Contact: SeongJae Park <sj@kernel.org> 377 Contact: SeongJae Park <sj@kernel.org>
384 Description: Reading this file returns the 378 Description: Reading this file returns the total size of regions that the
385 action of the scheme has succe 379 action of the scheme has successfully applied in bytes.
386 380
387 What: /sys/kernel/mm/damon/admin/kda 381 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/stats/qt_exceeds
388 Date: Mar 2022 382 Date: Mar 2022
389 Contact: SeongJae Park <sj@kernel.org> 383 Contact: SeongJae Park <sj@kernel.org>
390 Description: Reading this file returns the 384 Description: Reading this file returns the number of the exceed events of
391 the scheme's quotas. 385 the scheme's quotas.
392 386
393 What: /sys/kernel/mm/damon/admin/kda 387 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/tried_regions/total_bytes
394 Date: Jul 2023 388 Date: Jul 2023
395 Contact: SeongJae Park <sj@kernel.org> 389 Contact: SeongJae Park <sj@kernel.org>
396 Description: Reading this file returns the 390 Description: Reading this file returns the total amount of memory that
397 corresponding DAMON-based Oper 391 corresponding DAMON-based Operation Scheme's action has tried
398 to be applied. 392 to be applied.
399 393
400 What: /sys/kernel/mm/damon/admin/kda 394 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/tried_regions/<R>/start
401 Date: Oct 2022 395 Date: Oct 2022
402 Contact: SeongJae Park <sj@kernel.org> 396 Contact: SeongJae Park <sj@kernel.org>
403 Description: Reading this file returns the 397 Description: Reading this file returns the start address of a memory region
404 that corresponding DAMON-based 398 that corresponding DAMON-based Operation Scheme's action has
405 tried to be applied. 399 tried to be applied.
406 400
407 What: /sys/kernel/mm/damon/admin/kda 401 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/tried_regions/<R>/end
408 Date: Oct 2022 402 Date: Oct 2022
409 Contact: SeongJae Park <sj@kernel.org> 403 Contact: SeongJae Park <sj@kernel.org>
410 Description: Reading this file returns the 404 Description: Reading this file returns the end address of a memory region
411 that corresponding DAMON-based 405 that corresponding DAMON-based Operation Scheme's action has
412 tried to be applied. 406 tried to be applied.
413 407
414 What: /sys/kernel/mm/damon/admin/kda 408 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/tried_regions/<R>/nr_accesses
415 Date: Oct 2022 409 Date: Oct 2022
416 Contact: SeongJae Park <sj@kernel.org> 410 Contact: SeongJae Park <sj@kernel.org>
417 Description: Reading this file returns the 411 Description: Reading this file returns the 'nr_accesses' of a memory region
418 that corresponding DAMON-based 412 that corresponding DAMON-based Operation Scheme's action has
419 tried to be applied. 413 tried to be applied.
420 414
421 What: /sys/kernel/mm/damon/admin/kda 415 What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/tried_regions/<R>/age
422 Date: Oct 2022 416 Date: Oct 2022
423 Contact: SeongJae Park <sj@kernel.org> 417 Contact: SeongJae Park <sj@kernel.org>
424 Description: Reading this file returns the 418 Description: Reading this file returns the 'age' of a memory region that
425 corresponding DAMON-based Oper 419 corresponding DAMON-based Operation Scheme's action has tried
426 to be applied. 420 to be applied.
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.