1.. SPDX-License-Identifier: GPL-2.0
2
3DAMON Maintainer Entry Profile
4==============================
5
6The DAMON subsystem covers the files that are listed in 'DATA ACCESS MONITOR'
7section of 'MAINTAINERS' file.
8
9The mailing lists for the subsystem are damon@lists.linux.dev and
10linux-mm@kvack.org.  Patches should be made against the mm-unstable tree [1]_
11whenever possible and posted to the mailing lists.
12
13SCM Trees
14---------
15
16There are multiple Linux trees for DAMON development.  Patches under
17development or testing are queued in damon/next [2]_ by the DAMON maintainer.
18Sufficiently reviewed patches will be queued in mm-unstable [1]_ by the memory
19management subsystem maintainer.  After more sufficient tests, the patches will
20be queued in mm-stable [3]_ , and finally pull-requested to the mainline by the
21memory management subsystem maintainer.
22
23Note again the patches for review should be made against the mm-unstable
24tree[1] whenever possible.  damon/next is only for preview of others' works in
25progress.
26
27Submit checklist addendum
28-------------------------
29
30When making DAMON changes, you should do below.
31
32- Build changes related outputs including kernel and documents.
33- Ensure the builds introduce no new errors or warnings.
34- Run and ensure no new failures for DAMON selftests [4]_ and kunittests [5]_ .
35
36Further doing below and putting the results will be helpful.
37
38- Run damon-tests/corr [6]_ for normal changes.
39- Run damon-tests/perf [7]_ for performance changes.
40
41Key cycle dates
42---------------
43
44Patches can be sent anytime.  Key cycle dates of the mm-unstable[1] and
45mm-stable[3] trees depend on the memory management subsystem maintainer.
46
47Review cadence
48--------------
49
50The DAMON maintainer does the work on the usual work hour (09:00 to 17:00,
51Mon-Fri) in PST.  The response to patches will occasionally be slow.  Do not
52hesitate to send a ping if you have not heard back within a week of sending a
53patch.
54
55
56.. [1] https://git.kernel.org/akpm/mm/h/mm-unstable
57.. [2] https://git.kernel.org/sj/h/damon/next
58.. [3] https://git.kernel.org/akpm/mm/h/mm-stable
59.. [4] https://github.com/awslabs/damon-tests/blob/master/corr/run.sh#L49
60.. [5] https://github.com/awslabs/damon-tests/blob/master/corr/tests/kunit.sh
61.. [6] https://github.com/awslabs/damon-tests/tree/master/corr
62.. [7] https://github.com/awslabs/damon-tests/tree/master/perf
63