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