mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/chenhuacai/linux-loongson
synced 2025-08-30 03:57:32 +00:00
0b473f9e6e
Recently a new mm tree for new patches, namely mm-new, has been added. Update DAMON maintainer's profile doc for DAMON patches life cycle, which depend on those of mm trees. Link: https://lkml.kernel.org/r/20250705175000.56259-7-sj@kernel.org Signed-off-by: SeongJae Park <sj@kernel.org> Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
109 lines
4.6 KiB
ReStructuredText
109 lines
4.6 KiB
ReStructuredText
.. SPDX-License-Identifier: GPL-2.0
|
|
|
|
DAMON Maintainer Entry Profile
|
|
==============================
|
|
|
|
The DAMON subsystem covers the files that are listed in 'DATA ACCESS MONITOR'
|
|
section of 'MAINTAINERS' file.
|
|
|
|
The mailing lists for the subsystem are damon@lists.linux.dev and
|
|
linux-mm@kvack.org. Patches should be made against the `mm-new tree
|
|
<https://git.kernel.org/akpm/mm/h/mm-new>`_ whenever possible and posted to the
|
|
mailing lists.
|
|
|
|
SCM Trees
|
|
---------
|
|
|
|
There are multiple Linux trees for DAMON development. Patches under
|
|
development or testing are queued in `damon/next
|
|
<https://git.kernel.org/sj/h/damon/next>`_ by the DAMON maintainer.
|
|
Sufficiently reviewed patches will be queued in `mm-new
|
|
<https://git.kernel.org/akpm/mm/h/mm-new>`_ by the memory management subsystem
|
|
maintainer. As more sufficient tests are done, the patches will move to
|
|
`mm-unstable <https://git.kernel.org/akpm/mm/h/mm-unstable>`_ and then to
|
|
`mm-stable <https://git.kernel.org/akpm/mm/h/mm-stable>`_. And finally those
|
|
will be pull-requested to the mainline by the memory management subsystem
|
|
maintainer.
|
|
|
|
Note again the patches for `mm-new tree
|
|
<https://git.kernel.org/akpm/mm/h/mm-new>`_ are queued by the memory management
|
|
subsystem maintainer. If the patches requires some patches in `damon/next tree
|
|
<https://git.kernel.org/sj/h/damon/next>`_ which not yet merged in mm-new,
|
|
please make sure the requirement is clearly specified.
|
|
|
|
Submit checklist addendum
|
|
-------------------------
|
|
|
|
When making DAMON changes, you should do below.
|
|
|
|
- Build changes related outputs including kernel and documents.
|
|
- Ensure the builds introduce no new errors or warnings.
|
|
- Run and ensure no new failures for DAMON `selftests
|
|
<https://github.com/damonitor/damon-tests/blob/master/corr/run.sh#L49>`_ and
|
|
`kunittests
|
|
<https://github.com/damonitor/damon-tests/blob/master/corr/tests/kunit.sh>`_.
|
|
|
|
Further doing below and putting the results will be helpful.
|
|
|
|
- Run `damon-tests/corr
|
|
<https://github.com/damonitor/damon-tests/tree/master/corr>`_ for normal
|
|
changes.
|
|
- Run `damon-tests/perf
|
|
<https://github.com/damonitor/damon-tests/tree/master/perf>`_ for performance
|
|
changes.
|
|
|
|
Key cycle dates
|
|
---------------
|
|
|
|
Patches can be sent anytime. Key cycle dates of the `mm-new
|
|
<https://git.kernel.org/akpm/mm/h/mm-new>`_, `mm-unstable
|
|
<https://git.kernel.org/akpm/mm/h/mm-unstable>`_and `mm-stable
|
|
<https://git.kernel.org/akpm/mm/h/mm-stable>`_ trees depend on the memory
|
|
management subsystem maintainer.
|
|
|
|
Review cadence
|
|
--------------
|
|
|
|
The DAMON maintainer does the work on the usual work hour (09:00 to 17:00,
|
|
Mon-Fri) in PT (Pacific Time). The response to patches will occasionally be
|
|
slow. Do not hesitate to send a ping if you have not heard back within a week
|
|
of sending a patch.
|
|
|
|
Mailing tool
|
|
------------
|
|
|
|
Like many other Linux kernel subsystems, DAMON uses the mailing lists
|
|
(damon@lists.linux.dev and linux-mm@kvack.org) as the major communication
|
|
channel. There is a simple tool called `HacKerMaiL
|
|
<https://github.com/damonitor/hackermail>`_ (``hkml``), which is for people who
|
|
are not very familiar with the mailing lists based communication. The tool
|
|
could be particularly helpful for DAMON community members since it is developed
|
|
and maintained by DAMON maintainer. The tool is also officially announced to
|
|
support DAMON and general Linux kernel development workflow.
|
|
|
|
In other words, `hkml <https://github.com/damonitor/hackermail>`_ is a mailing
|
|
tool for DAMON community, which DAMON maintainer is committed to support.
|
|
Please feel free to try and report issues or feature requests for the tool to
|
|
the maintainer.
|
|
|
|
Community meetup
|
|
----------------
|
|
|
|
DAMON community is maintaining two bi-weekly meetup series for community
|
|
members who prefer synchronous conversations over mails.
|
|
|
|
The first one is for any discussion between every community member. No
|
|
reservation is needed.
|
|
|
|
The seconds one is for discussions on specific topics between restricted
|
|
members including the maintainer. The maintainer shares the available time
|
|
slots, and attendees should reserve one of those at least 24 hours before the
|
|
time slot, by reaching out to the maintainer.
|
|
|
|
Schedules and available reservation time slots are available at the Google `doc
|
|
<https://docs.google.com/document/d/1v43Kcj3ly4CYqmAkMaZzLiM2GEnWfgdGbZAH3mi2vpM/edit?usp=sharing>`_.
|
|
There is also a public Google `calendar
|
|
<https://calendar.google.com/calendar/u/0?cid=ZDIwOTA4YTMxNjc2MDQ3NTIyMmUzYTM5ZmQyM2U4NDA0ZGIwZjBiYmJlZGQxNDM0MmY4ZTRjOTE0NjdhZDRiY0Bncm91cC5jYWxlbmRhci5nb29nbGUuY29t>`_
|
|
that has the events. Anyone can subscribe it. DAMON maintainer will also
|
|
provide periodic reminder to the mailing list (damon@lists.linux.dev).
|