1f968c6a4SSeongJae Parkwhat:		/sys/kernel/mm/damon/
2f968c6a4SSeongJae ParkDate:		Mar 2022
3f968c6a4SSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
4f968c6a4SSeongJae ParkDescription:	Interface for Data Access MONitoring (DAMON).  Contains files
5f968c6a4SSeongJae Park		for controlling DAMON.  For more details on DAMON itself,
6f968c6a4SSeongJae Park		please refer to Documentation/admin-guide/mm/damon/index.rst.
7f968c6a4SSeongJae Park
8f968c6a4SSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/
9f968c6a4SSeongJae ParkDate:		Mar 2022
10f968c6a4SSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
11f968c6a4SSeongJae ParkDescription:	Interface for privileged users of DAMON.  Contains files for
12f968c6a4SSeongJae Park		controlling DAMON that aimed to be used by privileged users.
13f968c6a4SSeongJae Park
14f968c6a4SSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/nr_kdamonds
15f968c6a4SSeongJae ParkDate:		Mar 2022
16f968c6a4SSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
17f968c6a4SSeongJae ParkDescription:	Writing a number 'N' to this file creates the number of
18f968c6a4SSeongJae Park		directories for controlling each DAMON worker thread (kdamond)
19f968c6a4SSeongJae Park		named '0' to 'N-1' under the kdamonds/ directory.
20f968c6a4SSeongJae Park
21f968c6a4SSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/state
22f968c6a4SSeongJae ParkDate:		Mar 2022
23f968c6a4SSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
24f968c6a4SSeongJae ParkDescription:	Writing 'on' or 'off' to this file makes the kdamond starts or
25f968c6a4SSeongJae Park		stops, respectively.  Reading the file returns the keywords
26adc286e6SSeongJae Park		based on the current status.  Writing 'commit' to this file
27adc286e6SSeongJae Park		makes the kdamond reads the user inputs in the sysfs files
28adc286e6SSeongJae Park		except 'state' again.  Writing 'update_schemes_stats' to the
29adc286e6SSeongJae Park		file updates contents of schemes stats files of the kdamond.
301b0006daSSeongJae Park		Writing 'update_schemes_tried_regions' to the file updates
311b0006daSSeongJae Park		contents of 'tried_regions' directory of every scheme directory
32*e91b5ccfSSeongJae Park		of this kdamond.  Writing 'update_schemes_tried_bytes' to the
33*e91b5ccfSSeongJae Park		file updates only '.../tried_regions/total_bytes' files of this
34*e91b5ccfSSeongJae Park		kdamond.  Writing 'clear_schemes_tried_regions' to the file
35*e91b5ccfSSeongJae Park		removes contents of the 'tried_regions' directory.
36f968c6a4SSeongJae Park
37f968c6a4SSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/pid
38f968c6a4SSeongJae ParkDate:		Mar 2022
39f968c6a4SSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
40f968c6a4SSeongJae ParkDescription:	Reading this file returns the pid of the kdamond if it is
41f968c6a4SSeongJae Park		running.
42f968c6a4SSeongJae Park
43f968c6a4SSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/nr_contexts
44f968c6a4SSeongJae ParkDate:		Mar 2022
45f968c6a4SSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
46f968c6a4SSeongJae ParkDescription:	Writing a number 'N' to this file creates the number of
47f968c6a4SSeongJae Park		directories for controlling each DAMON context named '0' to
48f968c6a4SSeongJae Park		'N-1' under the contexts/ directory.
49f968c6a4SSeongJae Park
502fe60ec9SSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/avail_operations
512fe60ec9SSeongJae ParkDate:		Apr 2022
522fe60ec9SSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
532fe60ec9SSeongJae ParkDescription:	Reading this file returns the available monitoring operations
542fe60ec9SSeongJae Park		sets on the currently running kernel.
552fe60ec9SSeongJae Park
56f968c6a4SSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/operations
57f968c6a4SSeongJae ParkDate:		Mar 2022
58f968c6a4SSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
59f968c6a4SSeongJae ParkDescription:	Writing a keyword for a monitoring operations set ('vaddr' for
6091541808SSeongJae Park		virtual address spaces monitoring, 'fvaddr' for fixed virtual
6191541808SSeongJae Park		address ranges monitoring, and 'paddr' for the physical address
6291541808SSeongJae Park		space monitoring) to this file makes the context to use the
6391541808SSeongJae Park		operations set.  Reading the file returns the keyword for the
6491541808SSeongJae Park		operations set the context is set to use.
6591541808SSeongJae Park
6691541808SSeongJae Park		Note that only the operations sets that listed in
6791541808SSeongJae Park		'avail_operations' file are valid inputs.
68f968c6a4SSeongJae Park
69f968c6a4SSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/intervals/sample_us
70f968c6a4SSeongJae ParkDate:		Mar 2022
71f968c6a4SSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
72f968c6a4SSeongJae ParkDescription:	Writing a value to this file sets the sampling interval of the
73f968c6a4SSeongJae Park		DAMON context in microseconds as the value.  Reading this file
74f968c6a4SSeongJae Park		returns the value.
75f968c6a4SSeongJae Park
76f968c6a4SSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/intervals/aggr_us
77f968c6a4SSeongJae ParkDate:		Mar 2022
78f968c6a4SSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
79f968c6a4SSeongJae ParkDescription:	Writing a value to this file sets the aggregation interval of
80f968c6a4SSeongJae Park		the DAMON context in microseconds as the value.  Reading this
81f968c6a4SSeongJae Park		file returns the value.
82f968c6a4SSeongJae Park
83f968c6a4SSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/intervals/update_us
84f968c6a4SSeongJae ParkDate:		Mar 2022
85f968c6a4SSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
86f968c6a4SSeongJae ParkDescription:	Writing a value to this file sets the update interval of the
87f968c6a4SSeongJae Park		DAMON context in microseconds as the value.  Reading this file
88f968c6a4SSeongJae Park		returns the value.
89f968c6a4SSeongJae Park
90f968c6a4SSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/nr_regions/min
91f968c6a4SSeongJae Park
92f968c6a4SSeongJae ParkWDate:		Mar 2022
93f968c6a4SSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
94f968c6a4SSeongJae ParkDescription:	Writing a value to this file sets the minimum number of
95f968c6a4SSeongJae Park		monitoring regions of the DAMON context as the value.  Reading
96f968c6a4SSeongJae Park		this file returns the value.
97f968c6a4SSeongJae Park
98f968c6a4SSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/nr_regions/max
99f968c6a4SSeongJae ParkDate:		Mar 2022
100f968c6a4SSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
101f968c6a4SSeongJae ParkDescription:	Writing a value to this file sets the maximum number of
102f968c6a4SSeongJae Park		monitoring regions of the DAMON context as the value.  Reading
103f968c6a4SSeongJae Park		this file returns the value.
104f968c6a4SSeongJae Park
105f968c6a4SSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/targets/nr_targets
106f968c6a4SSeongJae ParkDate:		Mar 2022
107f968c6a4SSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
108f968c6a4SSeongJae ParkDescription:	Writing a number 'N' to this file creates the number of
109f968c6a4SSeongJae Park		directories for controlling each DAMON target of the context
110f968c6a4SSeongJae Park		named '0' to 'N-1' under the contexts/ directory.
111f968c6a4SSeongJae Park
112f968c6a4SSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/targets/<T>/pid_target
113f968c6a4SSeongJae ParkDate:		Mar 2022
114f968c6a4SSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
115f968c6a4SSeongJae ParkDescription:	Writing to and reading from this file sets and gets the pid of
116f968c6a4SSeongJae Park		the target process if the context is for virtual address spaces
117f968c6a4SSeongJae Park		monitoring, respectively.
118f968c6a4SSeongJae Park
119f968c6a4SSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/targets/<T>/regions/nr_regions
120f968c6a4SSeongJae ParkDate:		Mar 2022
121f968c6a4SSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
122f968c6a4SSeongJae ParkDescription:	Writing a number 'N' to this file creates the number of
123f968c6a4SSeongJae Park		directories for setting each DAMON target memory region of the
124f968c6a4SSeongJae Park		context named '0' to 'N-1' under the regions/ directory.  In
125f968c6a4SSeongJae Park		case of the virtual address space monitoring, DAMON
126f968c6a4SSeongJae Park		automatically sets the target memory region based on the target
127f968c6a4SSeongJae Park		processes' mappings.
128f968c6a4SSeongJae Park
129f968c6a4SSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/targets/<T>/regions/<R>/start
130f968c6a4SSeongJae ParkDate:		Mar 2022
131f968c6a4SSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
132f968c6a4SSeongJae ParkDescription:	Writing to and reading from this file sets and gets the start
133f968c6a4SSeongJae Park		address of the monitoring region.
134f968c6a4SSeongJae Park
135f968c6a4SSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/targets/<T>/regions/<R>/end
136f968c6a4SSeongJae ParkDate:		Mar 2022
137f968c6a4SSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
138f968c6a4SSeongJae ParkDescription:	Writing to and reading from this file sets and gets the end
139f968c6a4SSeongJae Park		address of the monitoring region.
140f968c6a4SSeongJae Park
141f968c6a4SSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/nr_schemes
142f968c6a4SSeongJae ParkDate:		Mar 2022
143f968c6a4SSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
144f968c6a4SSeongJae ParkDescription:	Writing a number 'N' to this file creates the number of
145f968c6a4SSeongJae Park		directories for controlling each DAMON-based operation scheme
146f968c6a4SSeongJae Park		of the context named '0' to 'N-1' under the schemes/ directory.
147f968c6a4SSeongJae Park
148f968c6a4SSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/action
149f968c6a4SSeongJae ParkDate:		Mar 2022
150f968c6a4SSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
151f968c6a4SSeongJae ParkDescription:	Writing to and reading from this file sets and gets the action
152f968c6a4SSeongJae Park		of the scheme.
153f968c6a4SSeongJae Park
154f968c6a4SSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/access_pattern/sz/min
155f968c6a4SSeongJae ParkDate:		Mar 2022
156f968c6a4SSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
157f968c6a4SSeongJae ParkDescription:	Writing to and reading from this file sets and gets the mimimum
158f968c6a4SSeongJae Park		size of the scheme's target regions in bytes.
159f968c6a4SSeongJae Park
160f968c6a4SSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/access_pattern/sz/max
161f968c6a4SSeongJae ParkDate:		Mar 2022
162f968c6a4SSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
163f968c6a4SSeongJae ParkDescription:	Writing to and reading from this file sets and gets the maximum
164f968c6a4SSeongJae Park		size of the scheme's target regions in bytes.
165f968c6a4SSeongJae Park
166f968c6a4SSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/access_pattern/nr_accesses/min
167f968c6a4SSeongJae ParkDate:		Mar 2022
168f968c6a4SSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
169f968c6a4SSeongJae ParkDescription:	Writing to and reading from this file sets and gets the manimum
170f968c6a4SSeongJae Park		'nr_accesses' of the scheme's target regions.
171f968c6a4SSeongJae Park
172f968c6a4SSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/access_pattern/nr_accesses/max
173f968c6a4SSeongJae ParkDate:		Mar 2022
174f968c6a4SSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
175f968c6a4SSeongJae ParkDescription:	Writing to and reading from this file sets and gets the maximum
176f968c6a4SSeongJae Park		'nr_accesses' of the scheme's target regions.
177f968c6a4SSeongJae Park
178f968c6a4SSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/access_pattern/age/min
179f968c6a4SSeongJae ParkDate:		Mar 2022
180f968c6a4SSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
181f968c6a4SSeongJae ParkDescription:	Writing to and reading from this file sets and gets the minimum
182f968c6a4SSeongJae Park		'age' of the scheme's target regions.
183f968c6a4SSeongJae Park
184f968c6a4SSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/access_pattern/age/max
185f968c6a4SSeongJae ParkDate:		Mar 2022
186f968c6a4SSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
187f968c6a4SSeongJae ParkDescription:	Writing to and reading from this file sets and gets the maximum
188f968c6a4SSeongJae Park		'age' of the scheme's target regions.
189f968c6a4SSeongJae Park
190f968c6a4SSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/ms
191f968c6a4SSeongJae ParkDate:		Mar 2022
192f968c6a4SSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
193f968c6a4SSeongJae ParkDescription:	Writing to and reading from this file sets and gets the time
194f968c6a4SSeongJae Park		quota of the scheme in milliseconds.
195f968c6a4SSeongJae Park
196f968c6a4SSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/bytes
197f968c6a4SSeongJae ParkDate:		Mar 2022
198f968c6a4SSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
199f968c6a4SSeongJae ParkDescription:	Writing to and reading from this file sets and gets the size
200f968c6a4SSeongJae Park		quota of the scheme in bytes.
201f968c6a4SSeongJae Park
202f968c6a4SSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/reset_interval_ms
203f968c6a4SSeongJae ParkDate:		Mar 2022
204f968c6a4SSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
205f968c6a4SSeongJae ParkDescription:	Writing to and reading from this file sets and gets the quotas
206f968c6a4SSeongJae Park		charge reset interval of the scheme in milliseconds.
207f968c6a4SSeongJae Park
208f968c6a4SSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/weights/sz_permil
209f968c6a4SSeongJae ParkDate:		Mar 2022
210f968c6a4SSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
211f968c6a4SSeongJae ParkDescription:	Writing to and reading from this file sets and gets the
212f968c6a4SSeongJae Park		under-quota limit regions prioritization weight for 'size' in
213f968c6a4SSeongJae Park		permil.
214f968c6a4SSeongJae Park
215f968c6a4SSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/weights/nr_accesses_permil
216f968c6a4SSeongJae ParkDate:		Mar 2022
217f968c6a4SSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
218f968c6a4SSeongJae ParkDescription:	Writing to and reading from this file sets and gets the
219f968c6a4SSeongJae Park		under-quota limit regions prioritization weight for
220f968c6a4SSeongJae Park		'nr_accesses' in permil.
221f968c6a4SSeongJae Park
222f968c6a4SSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/weights/age_permil
223f968c6a4SSeongJae ParkDate:		Mar 2022
224f968c6a4SSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
225f968c6a4SSeongJae ParkDescription:	Writing to and reading from this file sets and gets the
226f968c6a4SSeongJae Park		under-quota limit regions prioritization weight for 'age' in
227f968c6a4SSeongJae Park		permil.
228f968c6a4SSeongJae Park
229f968c6a4SSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/watermarks/metric
230f968c6a4SSeongJae ParkDate:		Mar 2022
231f968c6a4SSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
232f968c6a4SSeongJae ParkDescription:	Writing to and reading from this file sets and gets the metric
233f968c6a4SSeongJae Park		of the watermarks for the scheme.  The writable/readable
234f968c6a4SSeongJae Park		keywords for this file are 'none' for disabling the watermarks
235f968c6a4SSeongJae Park		feature, or 'free_mem_rate' for the system's global free memory
236f968c6a4SSeongJae Park		rate in permil.
237f968c6a4SSeongJae Park
238f968c6a4SSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/watermarks/interval_us
239f968c6a4SSeongJae ParkDate:		Mar 2022
240f968c6a4SSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
241f968c6a4SSeongJae ParkDescription:	Writing to and reading from this file sets and gets the metric
242f968c6a4SSeongJae Park		check interval of the watermarks for the scheme in
243f968c6a4SSeongJae Park		microseconds.
244f968c6a4SSeongJae Park
245f968c6a4SSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/watermarks/high
246f968c6a4SSeongJae ParkDate:		Mar 2022
247f968c6a4SSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
248f968c6a4SSeongJae ParkDescription:	Writing to and reading from this file sets and gets the high
249f968c6a4SSeongJae Park		watermark of the scheme in permil.
250f968c6a4SSeongJae Park
251f968c6a4SSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/watermarks/mid
252f968c6a4SSeongJae ParkDate:		Mar 2022
253f968c6a4SSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
254f968c6a4SSeongJae ParkDescription:	Writing to and reading from this file sets and gets the mid
255f968c6a4SSeongJae Park		watermark of the scheme in permil.
256f968c6a4SSeongJae Park
257f968c6a4SSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/watermarks/low
258f968c6a4SSeongJae ParkDate:		Mar 2022
259f968c6a4SSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
260f968c6a4SSeongJae ParkDescription:	Writing to and reading from this file sets and gets the low
261f968c6a4SSeongJae Park		watermark of the scheme in permil.
262f968c6a4SSeongJae Park
263497b099dSSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/nr_filters
264497b099dSSeongJae ParkDate:		Dec 2022
265497b099dSSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
266497b099dSSeongJae ParkDescription:	Writing a number 'N' to this file creates the number of
267497b099dSSeongJae Park		directories for setting filters of the scheme named '0' to
268497b099dSSeongJae Park		'N-1' under the filters/ directory.
269497b099dSSeongJae Park
270497b099dSSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/<F>/type
271497b099dSSeongJae ParkDate:		Dec 2022
272497b099dSSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
273497b099dSSeongJae ParkDescription:	Writing to and reading from this file sets and gets the type of
274497b099dSSeongJae Park		the memory of the interest.  'anon' for anonymous pages, or
275497b099dSSeongJae Park		'memcg' for specific memory cgroup can be written and read.
276497b099dSSeongJae Park
277497b099dSSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/<F>/memcg_path
278497b099dSSeongJae ParkDate:		Dec 2022
279497b099dSSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
280497b099dSSeongJae ParkDescription:	If 'memcg' is written to the 'type' file, writing to and
281497b099dSSeongJae Park		reading from this file sets and gets the path to the memory
282497b099dSSeongJae Park		cgroup of the interest.
283497b099dSSeongJae Park
284497b099dSSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/<F>/matching
285497b099dSSeongJae ParkDate:		Dec 2022
286497b099dSSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
287497b099dSSeongJae ParkDescription:	Writing 'Y' or 'N' to this file sets whether to filter out
288497b099dSSeongJae Park		pages that do or do not match to the 'type' and 'memcg_path',
289497b099dSSeongJae Park		respectively.  Filter out means the action of the scheme will
290497b099dSSeongJae Park		not be applied to.
291497b099dSSeongJae Park
292f968c6a4SSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/stats/nr_tried
293f968c6a4SSeongJae ParkDate:		Mar 2022
294f968c6a4SSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
295f968c6a4SSeongJae ParkDescription:	Reading this file returns the number of regions that the action
296f968c6a4SSeongJae Park		of the scheme has tried to be applied.
297f968c6a4SSeongJae Park
298f968c6a4SSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/stats/sz_tried
299f968c6a4SSeongJae ParkDate:		Mar 2022
300f968c6a4SSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
301f968c6a4SSeongJae ParkDescription:	Reading this file returns the total size of regions that the
302f968c6a4SSeongJae Park		action of the scheme has tried to be applied in bytes.
303f968c6a4SSeongJae Park
304f968c6a4SSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/stats/nr_applied
305f968c6a4SSeongJae ParkDate:		Mar 2022
306f968c6a4SSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
307f968c6a4SSeongJae ParkDescription:	Reading this file returns the number of regions that the action
308f968c6a4SSeongJae Park		of the scheme has successfully applied.
309f968c6a4SSeongJae Park
310f968c6a4SSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/stats/sz_applied
311f968c6a4SSeongJae ParkDate:		Mar 2022
312f968c6a4SSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
313f968c6a4SSeongJae ParkDescription:	Reading this file returns the total size of regions that the
314f968c6a4SSeongJae Park		action of the scheme has successfully applied in bytes.
315f968c6a4SSeongJae Park
316f968c6a4SSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/stats/qt_exceeds
317f968c6a4SSeongJae ParkDate:		Mar 2022
318f968c6a4SSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
319f968c6a4SSeongJae ParkDescription:	Reading this file returns the number of the exceed events of
320f968c6a4SSeongJae Park		the scheme's quotas.
3211b0006daSSeongJae Park
322*e91b5ccfSSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/tried_regions/total_bytes
323*e91b5ccfSSeongJae ParkDate:		Jul 2023
324*e91b5ccfSSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
325*e91b5ccfSSeongJae ParkDescription:	Reading this file returns the total amount of memory that
326*e91b5ccfSSeongJae Park		corresponding DAMON-based Operation Scheme's action has tried
327*e91b5ccfSSeongJae Park		to be applied.
328*e91b5ccfSSeongJae Park
3291b0006daSSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/tried_regions/<R>/start
3301b0006daSSeongJae ParkDate:		Oct 2022
3311b0006daSSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
3321b0006daSSeongJae ParkDescription:	Reading this file returns the start address of a memory region
3331b0006daSSeongJae Park		that corresponding DAMON-based Operation Scheme's action has
3341b0006daSSeongJae Park		tried to be applied.
3351b0006daSSeongJae Park
3361b0006daSSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/tried_regions/<R>/end
3371b0006daSSeongJae ParkDate:		Oct 2022
3381b0006daSSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
3391b0006daSSeongJae ParkDescription:	Reading this file returns the end address of a memory region
3401b0006daSSeongJae Park		that corresponding DAMON-based Operation Scheme's action has
3411b0006daSSeongJae Park		tried to be applied.
3421b0006daSSeongJae Park
3431b0006daSSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/tried_regions/<R>/nr_accesses
3441b0006daSSeongJae ParkDate:		Oct 2022
3451b0006daSSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
3461b0006daSSeongJae ParkDescription:	Reading this file returns the 'nr_accesses' of a memory region
3471b0006daSSeongJae Park		that corresponding DAMON-based Operation Scheme's action has
3481b0006daSSeongJae Park		tried to be applied.
3491b0006daSSeongJae Park
3501b0006daSSeongJae ParkWhat:		/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/tried_regions/<R>/age
3511b0006daSSeongJae ParkDate:		Oct 2022
3521b0006daSSeongJae ParkContact:	SeongJae Park <sj@kernel.org>
3531b0006daSSeongJae ParkDescription:	Reading this file returns the 'age' of a memory region that
3541b0006daSSeongJae Park		corresponding DAMON-based Operation Scheme's action has tried
3551b0006daSSeongJae Park		to be applied.
356