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