xref: /linux/Documentation/ABI/testing/sysfs-kernel-mm-damon (revision 8804d970fab45726b3c7cd7f240b31122aa94219)
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/weights/sz_permil
307Date:		Mar 2022
308Contact:	SeongJae Park <sj@kernel.org>
309Description:	Writing to and reading from this file sets and gets the
310		under-quota limit regions prioritization weight for 'size' in
311		permil.
312
313What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/weights/nr_accesses_permil
314Date:		Mar 2022
315Contact:	SeongJae Park <sj@kernel.org>
316Description:	Writing to and reading from this file sets and gets the
317		under-quota limit regions prioritization weight for
318		'nr_accesses' in permil.
319
320What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/weights/age_permil
321Date:		Mar 2022
322Contact:	SeongJae Park <sj@kernel.org>
323Description:	Writing to and reading from this file sets and gets the
324		under-quota limit regions prioritization weight for 'age' in
325		permil.
326
327What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/watermarks/metric
328Date:		Mar 2022
329Contact:	SeongJae Park <sj@kernel.org>
330Description:	Writing to and reading from this file sets and gets the metric
331		of the watermarks for the scheme.  The writable/readable
332		keywords for this file are 'none' for disabling the watermarks
333		feature, or 'free_mem_rate' for the system's global free memory
334		rate in permil.
335
336What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/watermarks/interval_us
337Date:		Mar 2022
338Contact:	SeongJae Park <sj@kernel.org>
339Description:	Writing to and reading from this file sets and gets the metric
340		check interval of the watermarks for the scheme in
341		microseconds.
342
343What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/watermarks/high
344Date:		Mar 2022
345Contact:	SeongJae Park <sj@kernel.org>
346Description:	Writing to and reading from this file sets and gets the high
347		watermark of the scheme in permil.
348
349What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/watermarks/mid
350Date:		Mar 2022
351Contact:	SeongJae Park <sj@kernel.org>
352Description:	Writing to and reading from this file sets and gets the mid
353		watermark of the scheme in permil.
354
355What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/watermarks/low
356Date:		Mar 2022
357Contact:	SeongJae Park <sj@kernel.org>
358Description:	Writing to and reading from this file sets and gets the low
359		watermark of the scheme in permil.
360
361What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/nr_filters
362Date:		Dec 2022
363Contact:	SeongJae Park <sj@kernel.org>
364Description:	Writing a number 'N' to this file creates the number of
365		directories for setting filters of the scheme named '0' to
366		'N-1' under the filters/ directory.
367
368What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/<F>/type
369Date:		Dec 2022
370Contact:	SeongJae Park <sj@kernel.org>
371Description:	Writing to and reading from this file sets and gets the type of
372		the memory of the interest.  'anon' for anonymous pages,
373		'memcg' for specific memory cgroup, 'young' for young pages,
374		'addr' for address range (an open-ended interval), or 'target'
375		for DAMON monitoring target can be written and read.
376
377What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/<F>/memcg_path
378Date:		Dec 2022
379Contact:	SeongJae Park <sj@kernel.org>
380Description:	If 'memcg' is written to the 'type' file, writing to and
381		reading from this file sets and gets the path to the memory
382		cgroup of the interest.
383
384What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/<F>/addr_start
385Date:		Jul 2023
386Contact:	SeongJae Park <sj@kernel.org>
387Description:	If 'addr' is written to the 'type' file, writing to or reading
388		from this file sets or gets the start address of the address
389		range for the filter.
390
391What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/<F>/addr_end
392Date:		Jul 2023
393Contact:	SeongJae Park <sj@kernel.org>
394Description:	If 'addr' is written to the 'type' file, writing to or reading
395		from this file sets or gets the end address of the address
396		range for the filter.
397
398What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/<F>/min
399Date:		Feb 2025
400Contact:	SeongJae Park <sj@kernel.org>
401Description:	If 'hugepage_size' is written to the 'type' file, writing to
402		or reading from this file sets or gets the minimum size of the
403		hugepage for the filter.
404
405What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/<F>/max
406Date:		Feb 2025
407Contact:	SeongJae Park <sj@kernel.org>
408Description:	If 'hugepage_size' is written to the 'type' file, writing to
409		or reading from this file sets or gets the maximum size of the
410		hugepage for the filter.
411
412What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/<F>/target_idx
413Date:		Dec 2022
414Contact:	SeongJae Park <sj@kernel.org>
415Description:	If 'target' is written to the 'type' file, writing to or
416		reading from this file sets or gets the index of the DAMON
417		monitoring target of the interest.
418
419What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/<F>/matching
420Date:		Dec 2022
421Contact:	SeongJae Park <sj@kernel.org>
422Description:	Writing 'Y' or 'N' to this file sets whether the filter is for
423		the memory of the 'type', or all except the 'type'.
424
425What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/<F>/allow
426Date:		Jan 2025
427Contact:	SeongJae Park <sj@kernel.org>
428Description:	Writing 'Y' or 'N' to this file sets whether to allow or reject
429		applying the scheme's action to the memory that satisfies the
430		'type' and the 'matching' of the directory.
431
432What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/core_filters
433Date:		Feb 2025
434Contact:	SeongJae Park <sj@kernel.org>
435Description:	Directory for DAMON core layer-handled DAMOS filters.  Files
436		under this directory works same to those of
437		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters
438		directory.
439
440What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/ops_filters
441Date:		Feb 2025
442Contact:	SeongJae Park <sj@kernel.org>
443Description:	Directory for DAMON operations set layer-handled DAMOS filters.
444		Files under this directory works same to those of
445		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters
446		directory.
447
448What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/dests/nr_dests
449Date:		Jul 2025
450Contact:	SeongJae Park <sj@kernel.org>
451Description:	Writing a number 'N' to this file creates the number of
452		directories for setting action destinations of the scheme named
453		'0' to 'N-1' under the dests/ directory.
454
455What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/dests/<D>/id
456Date:		Jul 2025
457Contact:	SeongJae Park <sj@kernel.org>
458Description:	Writing to and reading from this file sets and gets the id of
459		the DAMOS action destination.  For DAMOS_MIGRATE_{HOT,COLD}
460		actions, the destination node's node id can be written and
461		read.
462
463What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/dests/<D>/weight
464Date:		Jul 2025
465Contact:	SeongJae Park <sj@kernel.org>
466Description:	Writing to and reading from this file sets and gets the weight
467		of the DAMOS action destination to select as the destination of
468		each action among the destinations.
469
470What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/stats/nr_tried
471Date:		Mar 2022
472Contact:	SeongJae Park <sj@kernel.org>
473Description:	Reading this file returns the number of regions that the action
474		of the scheme has tried to be applied.
475
476What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/stats/sz_tried
477Date:		Mar 2022
478Contact:	SeongJae Park <sj@kernel.org>
479Description:	Reading this file returns the total size of regions that the
480		action of the scheme has tried to be applied in bytes.
481
482What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/stats/nr_applied
483Date:		Mar 2022
484Contact:	SeongJae Park <sj@kernel.org>
485Description:	Reading this file returns the number of regions that the action
486		of the scheme has successfully applied.
487
488What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/stats/sz_applied
489Date:		Mar 2022
490Contact:	SeongJae Park <sj@kernel.org>
491Description:	Reading this file returns the total size of regions that the
492		action of the scheme has successfully applied in bytes.
493
494What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/stats/sz_ops_filter_passed
495Date:		Dec 2024
496Contact:	SeongJae Park <sj@kernel.org>
497Description:	Reading this file returns the total size of memory that passed
498		DAMON operations layer-handled filters of the scheme in bytes.
499
500What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/stats/qt_exceeds
501Date:		Mar 2022
502Contact:	SeongJae Park <sj@kernel.org>
503Description:	Reading this file returns the number of the exceed events of
504		the scheme's quotas.
505
506What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/tried_regions/total_bytes
507Date:		Jul 2023
508Contact:	SeongJae Park <sj@kernel.org>
509Description:	Reading this file returns the total amount of memory that
510		corresponding DAMON-based Operation Scheme's action has tried
511		to be applied.
512
513What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/tried_regions/<R>/start
514Date:		Oct 2022
515Contact:	SeongJae Park <sj@kernel.org>
516Description:	Reading this file returns the start address of a memory region
517		that corresponding DAMON-based Operation Scheme's action has
518		tried to be applied.
519
520What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/tried_regions/<R>/end
521Date:		Oct 2022
522Contact:	SeongJae Park <sj@kernel.org>
523Description:	Reading this file returns the end address of a memory region
524		that corresponding DAMON-based Operation Scheme's action has
525		tried to be applied.
526
527What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/tried_regions/<R>/nr_accesses
528Date:		Oct 2022
529Contact:	SeongJae Park <sj@kernel.org>
530Description:	Reading this file returns the 'nr_accesses' of a memory region
531		that corresponding DAMON-based Operation Scheme's action has
532		tried to be applied.
533
534What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/tried_regions/<R>/age
535Date:		Oct 2022
536Contact:	SeongJae Park <sj@kernel.org>
537Description:	Reading this file returns the 'age' of a memory region that
538		corresponding DAMON-based Operation Scheme's action has tried
539		to be applied.
540
541What:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/tried_regions/<R>/sz_filter_passed
542Date:		Dec 2024
543Contact:	SeongJae Park <sj@kernel.org>
544Description:	Reading this file returns the size of the memory in the region
545		that passed DAMON operations layer-handled filters of the
546		scheme in bytes.
547