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