mirror of
git://git.yoctoproject.org/linux-yocto.git
synced 2025-07-05 05:15:23 +02:00
e9c0bfd704
We added a public Google calendar for easy sharing of DAMON bi-weekly meetups[1]. Add it to the official document for a better visibility. [1] https://lore.kernel.org/all/20240717235812.53087-1-sj@kernel.org/ Link: https://lkml.kernel.org/r/20240826015741.80707-4-sj@kernel.org Signed-off-by: SeongJae Park <sj@kernel.org> Cc: Alex Shi <alexs@kernel.org> Cc: Hu Haowen <2023002089@link.tyut.edu.cn> Cc: Jonathan Corbet <corbet@lwn.net> Cc: Yanteng Si <siyanteng@loongson.cn> Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
106 lines
4.5 KiB
ReStructuredText
106 lines
4.5 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-unstable `tree
|
|
<https://git.kernel.org/akpm/mm/h/mm-unstable>` 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-unstable
|
|
<https://git.kernel.org/akpm/mm/h/mm-unstable>` by the memory management
|
|
subsystem maintainer. After more sufficient tests, the patches will be queued
|
|
in `mm-stable <https://git.kernel.org/akpm/mm/h/mm-stable>` , and finally
|
|
pull-requested to the mainline by the memory management subsystem maintainer.
|
|
|
|
Note again the patches for mm-unstable `tree
|
|
<https://git.kernel.org/akpm/mm/h/mm-unstable>` 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-unstable, 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/awslabs/damon-tests/blob/master/corr/run.sh#L49>` and
|
|
`kunittests
|
|
<https://github.com/awslabs/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/awslabs/damon-tests/tree/master/corr>` for normal
|
|
changes.
|
|
- Run `damon-tests/perf
|
|
<https://github.com/awslabs/damon-tests/tree/master/perf>` for performance
|
|
changes.
|
|
|
|
Key cycle dates
|
|
---------------
|
|
|
|
Patches can be sent anytime. Key cycle dates of the `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).
|