xref: /linux/Documentation/ABI/testing/sysfs-kernel-mm-damon (revision 40d923acfa83d514718d1aee96b2af91e4e1fff2)
1what:		/sys/kernel/mm/damon/
2Date:		Mar 2022
3Contact:	SeongJae Park <sj@kernel.org>
4Description:	Interface for Data Access MONitoring (DAMON).  Contains files
5		for controlling DAMON.  For more details on DAMON itself,
6		please refer to Documentation/admin-guide/mm/damon/index.rst.
7
8What:		/sys/kernel/mm/damon/admin/
9Date:		Mar 2022
10Contact:	SeongJae Park <sj@kernel.org>
11Description:	Interface for privileged users of DAMON.  Contains files for
12		controlling DAMON that aimed to be used by privileged users.
13
14What:		/sys/kernel/mm/damon/admin/kdamonds/nr_kdamonds
15Date:		Mar 2022
16Contact:	SeongJae Park <sj@kernel.org>
17Description:	Writing a number 'N' to this file creates the number of
18		directories for controlling each DAMON worker thread (kdamond)
19		named '0' to 'N-1' under the kdamonds/ directory.
20
21What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/state
22Date:		Mar 2022
23Contact:	SeongJae Park <sj@kernel.org>
24Description:	Writing 'on' or 'off' to this file makes the kdamond starts or
25		stops, respectively.  Reading the file returns the keywords
26		based on the current status.  Writing 'commit' to this file
27		makes the kdamond reads the user inputs in the sysfs files
28		except 'state' again.  Writing 'commit_schemes_quota_goals' to
29		this file makes the kdamond reads the quota goal files again.
30		Writing 'update_schemes_stats' to the file updates contents of
31		schemes stats files of the kdamond.  Writing
32		'update_schemes_tried_regions' to the file updates contents of
33		'tried_regions' directory of every scheme directory of this
34		kdamond.  Writing 'update_schemes_tried_bytes' to the file
35		updates only '.../tried_regions/total_bytes' files of this
36		kdamond.  Writing 'clear_schemes_tried_regions' to the file
37		removes contents of the 'tried_regions' directory.  Writing
38		'update_schemes_effective_quotas' to the file updates
39		'.../quotas/effective_bytes' files of this kdamond.
40
41What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/pid
42Date:		Mar 2022
43Contact:	SeongJae Park <sj@kernel.org>
44Description:	Reading this file returns the pid of the kdamond if it is
45		running.
46
47What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/refresh_ms
48Date:		Jul 2025
49Contact:	SeongJae Park <sj@kernel.org>
50Description:	Writing a value to this file sets the time interval for
51		automatic DAMON status file contents update.  Writing '0'
52		disables the update.  Reading this file returns the value.
53
54What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/nr_contexts
55Date:		Mar 2022
56Contact:	SeongJae Park <sj@kernel.org>
57Description:	Writing a number 'N' to this file creates the number of
58		directories for controlling each DAMON context named '0' to
59		'N-1' under the contexts/ directory.
60
61What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/avail_operations
62Date:		Apr 2022
63Contact:	SeongJae Park <sj@kernel.org>
64Description:	Reading this file returns the available monitoring operations
65		sets on the currently running kernel.
66
67What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/operations
68Date:		Mar 2022
69Contact:	SeongJae Park <sj@kernel.org>
70Description:	Writing a keyword for a monitoring operations set ('vaddr' for
71		virtual address spaces monitoring, 'fvaddr' for fixed virtual
72		address ranges monitoring, and 'paddr' for the physical address
73		space monitoring) to this file makes the context to use the
74		operations set.  Reading the file returns the keyword for the
75		operations set the context is set to use.
76
77		Note that only the operations sets that listed in
78		'avail_operations' file are valid inputs.
79
80What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/addr_unit
81Date:		Aug 2025
82Contact:	SeongJae Park <sj@kernel.org>
83Description:	Writing an integer to this file sets the 'address unit'
84		parameter of the given operations set of the context.  Reading
85		the file returns the last-written 'address unit' value.
86
87What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/intervals/sample_us
88Date:		Mar 2022
89Contact:	SeongJae Park <sj@kernel.org>
90Description:	Writing a value to this file sets the sampling interval of the
91		DAMON context in microseconds as the value.  Reading this file
92		returns the value.
93
94What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/intervals/aggr_us
95Date:		Mar 2022
96Contact:	SeongJae Park <sj@kernel.org>
97Description:	Writing a value to this file sets the aggregation interval of
98		the DAMON context in microseconds as the value.  Reading this
99		file returns the value.
100
101What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/intervals/update_us
102Date:		Mar 2022
103Contact:	SeongJae Park <sj@kernel.org>
104Description:	Writing a value to this file sets the update interval of the
105		DAMON context in microseconds as the value.  Reading this file
106		returns the value.
107
108What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/intervals/intrvals_goal/access_bp
109Date:		Feb 2025
110Contact:	SeongJae Park <sj@kernel.org>
111Description:	Writing a value to this file sets the monitoring intervals
112		auto-tuning target DAMON-observed access events ratio within
113		the given time interval (aggrs in same directory), in bp
114		(1/10,000).  Reading this file returns the value.
115
116What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/intervals/intrvals_goal/aggrs
117Date:		Feb 2025
118Contact:	SeongJae Park <sj@kernel.org>
119Description:	Writing a value to this file sets the time interval to achieve
120		the monitoring intervals auto-tuning target DAMON-observed
121		access events ratio (access_bp in same directory) within.
122		Reading this file returns the value.
123
124What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/intervals/intrvals_goal/min_sample_us
125Date:		Feb 2025
126Contact:	SeongJae Park <sj@kernel.org>
127Description:	Writing a value to this file sets the minimum value of
128		auto-tuned sampling interval in microseconds.  Reading this
129		file returns the value.
130
131What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/intervals/intrvals_goal/max_sample_us
132Date:		Feb 2025
133Contact:	SeongJae Park <sj@kernel.org>
134Description:	Writing a value to this file sets the maximum value of
135		auto-tuned sampling interval in microseconds.  Reading this
136		file returns the value.
137
138What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/nr_regions/min
139
140WDate:		Mar 2022
141Contact:	SeongJae Park <sj@kernel.org>
142Description:	Writing a value to this file sets the minimum number of
143		monitoring regions of the DAMON context as the value.  Reading
144		this file returns the value.
145
146What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/nr_regions/max
147Date:		Mar 2022
148Contact:	SeongJae Park <sj@kernel.org>
149Description:	Writing a value to this file sets the maximum number of
150		monitoring regions of the DAMON context as the value.  Reading
151		this file returns the value.
152
153What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/targets/nr_targets
154Date:		Mar 2022
155Contact:	SeongJae Park <sj@kernel.org>
156Description:	Writing a number 'N' to this file creates the number of
157		directories for controlling each DAMON target of the context
158		named '0' to 'N-1' under the contexts/ directory.
159
160What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/targets/<T>/pid_target
161Date:		Mar 2022
162Contact:	SeongJae Park <sj@kernel.org>
163Description:	Writing to and reading from this file sets and gets the pid of
164		the target process if the context is for virtual address spaces
165		monitoring, respectively.
166
167What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/targets/<T>/regions/nr_regions
168Date:		Mar 2022
169Contact:	SeongJae Park <sj@kernel.org>
170Description:	Writing a number 'N' to this file creates the number of
171		directories for setting each DAMON target memory region of the
172		context named '0' to 'N-1' under the regions/ directory.  In
173		case of the virtual address space monitoring, DAMON
174		automatically sets the target memory region based on the target
175		processes' mappings.
176
177What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/targets/<T>/regions/<R>/start
178Date:		Mar 2022
179Contact:	SeongJae Park <sj@kernel.org>
180Description:	Writing to and reading from this file sets and gets the start
181		address of the monitoring region.
182
183What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/targets/<T>/regions/<R>/end
184Date:		Mar 2022
185Contact:	SeongJae Park <sj@kernel.org>
186Description:	Writing to and reading from this file sets and gets the end
187		address of the monitoring region.
188
189What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/nr_schemes
190Date:		Mar 2022
191Contact:	SeongJae Park <sj@kernel.org>
192Description:	Writing a number 'N' to this file creates the number of
193		directories for controlling each DAMON-based operation scheme
194		of the context named '0' to 'N-1' under the schemes/ directory.
195
196What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/action
197Date:		Mar 2022
198Contact:	SeongJae Park <sj@kernel.org>
199Description:	Writing to and reading from this file sets and gets the action
200		of the scheme.
201
202What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/target_nid
203Date:		Jun 2024
204Contact:	SeongJae Park <sj@kernel.org>
205Description:	Action's target NUMA node id.  Supported by only relevant
206		actions.
207
208What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/apply_interval_us
209Date:		Sep 2023
210Contact:	SeongJae Park <sj@kernel.org>
211Description:	Writing a value to this file sets the action apply interval of
212		the scheme in microseconds.  Reading this file returns the
213		value.
214
215What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/access_pattern/sz/min
216Date:		Mar 2022
217Contact:	SeongJae Park <sj@kernel.org>
218Description:	Writing to and reading from this file sets and gets the minimum
219		size of the scheme's target regions in bytes.
220
221What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/access_pattern/sz/max
222Date:		Mar 2022
223Contact:	SeongJae Park <sj@kernel.org>
224Description:	Writing to and reading from this file sets and gets the maximum
225		size of the scheme's target regions in bytes.
226
227What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/access_pattern/nr_accesses/min
228Date:		Mar 2022
229Contact:	SeongJae Park <sj@kernel.org>
230Description:	Writing to and reading from this file sets and gets the manimum
231		'nr_accesses' of the scheme's target regions.
232
233What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/access_pattern/nr_accesses/max
234Date:		Mar 2022
235Contact:	SeongJae Park <sj@kernel.org>
236Description:	Writing to and reading from this file sets and gets the maximum
237		'nr_accesses' of the scheme's target regions.
238
239What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/access_pattern/age/min
240Date:		Mar 2022
241Contact:	SeongJae Park <sj@kernel.org>
242Description:	Writing to and reading from this file sets and gets the minimum
243		'age' of the scheme's target regions.
244
245What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/access_pattern/age/max
246Date:		Mar 2022
247Contact:	SeongJae Park <sj@kernel.org>
248Description:	Writing to and reading from this file sets and gets the maximum
249		'age' of the scheme's target regions.
250
251What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/ms
252Date:		Mar 2022
253Contact:	SeongJae Park <sj@kernel.org>
254Description:	Writing to and reading from this file sets and gets the time
255		quota of the scheme in milliseconds.
256
257What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/bytes
258Date:		Mar 2022
259Contact:	SeongJae Park <sj@kernel.org>
260Description:	Writing to and reading from this file sets and gets the size
261		quota of the scheme in bytes.
262
263What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/effective_bytes
264Date:		Feb 2024
265Contact:	SeongJae Park <sj@kernel.org>
266Description:	Reading from this file gets the effective size quota of the
267		scheme in bytes, which adjusted for the time quota and goals.
268
269What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/reset_interval_ms
270Date:		Mar 2022
271Contact:	SeongJae Park <sj@kernel.org>
272Description:	Writing to and reading from this file sets and gets the quotas
273		charge reset interval of the scheme in milliseconds.
274
275What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/goals/nr_goals
276Date:		Nov 2023
277Contact:	SeongJae Park <sj@kernel.org>
278Description:	Writing a number 'N' to this file creates the number of
279		directories for setting automatic tuning of the scheme's
280		aggressiveness named '0' to 'N-1' under the goals/ directory.
281
282What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/goals/<G>/target_metric
283Date:		Feb 2024
284Contact:	SeongJae Park <sj@kernel.org>
285Description:	Writing to and reading from this file sets and gets the quota
286		auto-tuning goal metric.
287
288What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/goals/<G>/target_value
289Date:		Nov 2023
290Contact:	SeongJae Park <sj@kernel.org>
291Description:	Writing to and reading from this file sets and gets the target
292		value of the goal metric.
293
294What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/goals/<G>/current_value
295Date:		Nov 2023
296Contact:	SeongJae Park <sj@kernel.org>
297Description:	Writing to and reading from this file sets and gets the current
298		value of the goal metric.
299
300What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/goals/<G>/nid
301Date:		Apr 2025
302Contact:	SeongJae Park <sj@kernel.org>
303Description:	Writing to and reading from this file sets and gets the nid
304		parameter of the goal.
305
306What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/goals/<G>/path
307Date:		Oct 2025
308Contact:	SeongJae Park <sj@kernel.org>
309Description:	Writing to and reading from this file sets and gets the path
310		parameter of the goal.
311
312What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/weights/sz_permil
313Date:		Mar 2022
314Contact:	SeongJae Park <sj@kernel.org>
315Description:	Writing to and reading from this file sets and gets the
316		under-quota limit regions prioritization weight for 'size' in
317		permil.
318
319What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/weights/nr_accesses_permil
320Date:		Mar 2022
321Contact:	SeongJae Park <sj@kernel.org>
322Description:	Writing to and reading from this file sets and gets the
323		under-quota limit regions prioritization weight for
324		'nr_accesses' in permil.
325
326What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/weights/age_permil
327Date:		Mar 2022
328Contact:	SeongJae Park <sj@kernel.org>
329Description:	Writing to and reading from this file sets and gets the
330		under-quota limit regions prioritization weight for 'age' in
331		permil.
332
333What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/watermarks/metric
334Date:		Mar 2022
335Contact:	SeongJae Park <sj@kernel.org>
336Description:	Writing to and reading from this file sets and gets the metric
337		of the watermarks for the scheme.  The writable/readable
338		keywords for this file are 'none' for disabling the watermarks
339		feature, or 'free_mem_rate' for the system's global free memory
340		rate in permil.
341
342What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/watermarks/interval_us
343Date:		Mar 2022
344Contact:	SeongJae Park <sj@kernel.org>
345Description:	Writing to and reading from this file sets and gets the metric
346		check interval of the watermarks for the scheme in
347		microseconds.
348
349What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/watermarks/high
350Date:		Mar 2022
351Contact:	SeongJae Park <sj@kernel.org>
352Description:	Writing to and reading from this file sets and gets the high
353		watermark of the scheme in permil.
354
355What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/watermarks/mid
356Date:		Mar 2022
357Contact:	SeongJae Park <sj@kernel.org>
358Description:	Writing to and reading from this file sets and gets the mid
359		watermark of the scheme in permil.
360
361What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/watermarks/low
362Date:		Mar 2022
363Contact:	SeongJae Park <sj@kernel.org>
364Description:	Writing to and reading from this file sets and gets the low
365		watermark of the scheme in permil.
366
367What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/nr_filters
368Date:		Dec 2022
369Contact:	SeongJae Park <sj@kernel.org>
370Description:	Writing a number 'N' to this file creates the number of
371		directories for setting filters of the scheme named '0' to
372		'N-1' under the filters/ directory.
373
374What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/<F>/type
375Date:		Dec 2022
376Contact:	SeongJae Park <sj@kernel.org>
377Description:	Writing to and reading from this file sets and gets the type of
378		the memory of the interest.  'anon' for anonymous pages,
379		'memcg' for specific memory cgroup, 'young' for young pages,
380		'addr' for address range (an open-ended interval), or 'target'
381		for DAMON monitoring target can be written and read.
382
383What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/<F>/memcg_path
384Date:		Dec 2022
385Contact:	SeongJae Park <sj@kernel.org>
386Description:	If 'memcg' is written to the 'type' file, writing to and
387		reading from this file sets and gets the path to the memory
388		cgroup of the interest.
389
390What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/<F>/addr_start
391Date:		Jul 2023
392Contact:	SeongJae Park <sj@kernel.org>
393Description:	If 'addr' is written to the 'type' file, writing to or reading
394		from this file sets or gets the start address of the address
395		range for the filter.
396
397What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/<F>/addr_end
398Date:		Jul 2023
399Contact:	SeongJae Park <sj@kernel.org>
400Description:	If 'addr' is written to the 'type' file, writing to or reading
401		from this file sets or gets the end address of the address
402		range for the filter.
403
404What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/<F>/min
405Date:		Feb 2025
406Contact:	SeongJae Park <sj@kernel.org>
407Description:	If 'hugepage_size' is written to the 'type' file, writing to
408		or reading from this file sets or gets the minimum size of the
409		hugepage for the filter.
410
411What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/<F>/max
412Date:		Feb 2025
413Contact:	SeongJae Park <sj@kernel.org>
414Description:	If 'hugepage_size' is written to the 'type' file, writing to
415		or reading from this file sets or gets the maximum size of the
416		hugepage for the filter.
417
418What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/<F>/target_idx
419Date:		Dec 2022
420Contact:	SeongJae Park <sj@kernel.org>
421Description:	If 'target' is written to the 'type' file, writing to or
422		reading from this file sets or gets the index of the DAMON
423		monitoring target of the interest.
424
425What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/<F>/matching
426Date:		Dec 2022
427Contact:	SeongJae Park <sj@kernel.org>
428Description:	Writing 'Y' or 'N' to this file sets whether the filter is for
429		the memory of the 'type', or all except the 'type'.
430
431What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/<F>/allow
432Date:		Jan 2025
433Contact:	SeongJae Park <sj@kernel.org>
434Description:	Writing 'Y' or 'N' to this file sets whether to allow or reject
435		applying the scheme's action to the memory that satisfies the
436		'type' and the 'matching' of the directory.
437
438What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/core_filters
439Date:		Feb 2025
440Contact:	SeongJae Park <sj@kernel.org>
441Description:	Directory for DAMON core layer-handled DAMOS filters.  Files
442		under this directory works same to those of
443		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters
444		directory.
445
446What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/ops_filters
447Date:		Feb 2025
448Contact:	SeongJae Park <sj@kernel.org>
449Description:	Directory for DAMON operations set layer-handled DAMOS filters.
450		Files under this directory works same to those of
451		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters
452		directory.
453
454What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/dests/nr_dests
455Date:		Jul 2025
456Contact:	SeongJae Park <sj@kernel.org>
457Description:	Writing a number 'N' to this file creates the number of
458		directories for setting action destinations of the scheme named
459		'0' to 'N-1' under the dests/ directory.
460
461What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/dests/<D>/id
462Date:		Jul 2025
463Contact:	SeongJae Park <sj@kernel.org>
464Description:	Writing to and reading from this file sets and gets the id of
465		the DAMOS action destination.  For DAMOS_MIGRATE_{HOT,COLD}
466		actions, the destination node's node id can be written and
467		read.
468
469What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/dests/<D>/weight
470Date:		Jul 2025
471Contact:	SeongJae Park <sj@kernel.org>
472Description:	Writing to and reading from this file sets and gets the weight
473		of the DAMOS action destination to select as the destination of
474		each action among the destinations.
475
476What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/stats/nr_tried
477Date:		Mar 2022
478Contact:	SeongJae Park <sj@kernel.org>
479Description:	Reading this file returns the number of regions that the action
480		of the scheme has tried to be applied.
481
482What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/stats/sz_tried
483Date:		Mar 2022
484Contact:	SeongJae Park <sj@kernel.org>
485Description:	Reading this file returns the total size of regions that the
486		action of the scheme has tried to be applied in bytes.
487
488What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/stats/nr_applied
489Date:		Mar 2022
490Contact:	SeongJae Park <sj@kernel.org>
491Description:	Reading this file returns the number of regions that the action
492		of the scheme has successfully applied.
493
494What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/stats/sz_applied
495Date:		Mar 2022
496Contact:	SeongJae Park <sj@kernel.org>
497Description:	Reading this file returns the total size of regions that the
498		action of the scheme has successfully applied in bytes.
499
500What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/stats/sz_ops_filter_passed
501Date:		Dec 2024
502Contact:	SeongJae Park <sj@kernel.org>
503Description:	Reading this file returns the total size of memory that passed
504		DAMON operations layer-handled filters of the scheme in bytes.
505
506What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/stats/qt_exceeds
507Date:		Mar 2022
508Contact:	SeongJae Park <sj@kernel.org>
509Description:	Reading this file returns the number of the exceed events of
510		the scheme's quotas.
511
512What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/tried_regions/total_bytes
513Date:		Jul 2023
514Contact:	SeongJae Park <sj@kernel.org>
515Description:	Reading this file returns the total amount of memory that
516		corresponding DAMON-based Operation Scheme's action has tried
517		to be applied.
518
519What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/tried_regions/<R>/start
520Date:		Oct 2022
521Contact:	SeongJae Park <sj@kernel.org>
522Description:	Reading this file returns the start address of a memory region
523		that corresponding DAMON-based Operation Scheme's action has
524		tried to be applied.
525
526What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/tried_regions/<R>/end
527Date:		Oct 2022
528Contact:	SeongJae Park <sj@kernel.org>
529Description:	Reading this file returns the end address of a memory region
530		that corresponding DAMON-based Operation Scheme's action has
531		tried to be applied.
532
533What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/tried_regions/<R>/nr_accesses
534Date:		Oct 2022
535Contact:	SeongJae Park <sj@kernel.org>
536Description:	Reading this file returns the 'nr_accesses' of a memory region
537		that corresponding DAMON-based Operation Scheme's action has
538		tried to be applied.
539
540What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/tried_regions/<R>/age
541Date:		Oct 2022
542Contact:	SeongJae Park <sj@kernel.org>
543Description:	Reading this file returns the 'age' of a memory region that
544		corresponding DAMON-based Operation Scheme's action has tried
545		to be applied.
546
547What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/tried_regions/<R>/sz_filter_passed
548Date:		Dec 2024
549Contact:	SeongJae Park <sj@kernel.org>
550Description:	Reading this file returns the size of the memory in the region
551		that passed DAMON operations layer-handled filters of the
552		scheme in bytes.
553