[RFC PATCH 09/27] Docs/mm/damon/design: update for report system

From: SJ Park

Date: Sun Nov 15 2026 - 15:29:46 EST


Update DAMON design for the data attribute report system.

Signed-off-by: SJ Park <sj@xxxxxxxxxx>
---
Documentation/mm/damon/design.rst | 26 ++++++++++++++++++++++++++
1 file changed, 26 insertions(+)

diff --git a/Documentation/mm/damon/design.rst b/Documentation/mm/damon/design.rst
index b676be6971589..e0eb53d7694f7 100644
--- a/Documentation/mm/damon/design.rst
+++ b/Documentation/mm/damon/design.rst
@@ -356,6 +356,32 @@ monitoring.
Refer to the :ref:`admin guide <damon_usage_sysfs_probes>` to know how users
can use the mode.

+.. _damon_design_attr_reporting:
+
+Data Attributes Reporting
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+DAMON-external entities such as other kernel components and users may have
+special data attribute information. DAMON provides a system that let them
+report such information to DAMON.
+
+DAMON provides the kernel API for submitting a report of data attribute
+information to DAMON. A report describes what type of the report is,
+representing the reporting data attribute type. A report also describes the
+address range of the memory that the report is made for. Depending on the
+report type, the report can have additional information. The report is saved
+in DAMON's internal queue. The queue is automatically managed by DAMON with
+its best effort.
+
+DAMON provides the user :ref:`ABI <damon_usage_sysfs_reports_producers>` for
+configuring report producers. Each producer is configured for a specific
+report type. Users can dynamically enable and disable those. When enabled, it
+can generate and submit reports of the given type. The generations and
+submissions could be done automatically by the kernel or manually by the user,
+depending on the type of the report.
+
+For now, no report type is supported.
+
Dynamic Target Space Updates Handling
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

--
2.47.3