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