[RFC PATCH 26/27] Docs/admin-guide/mm/damon/usage: update for user_report report support

From: SJ Park

Date: Sun Nov 15 2026 - 15:30:30 EST


Update DAMON usage document for the newly added user_report type data
attribute report support.

Signed-off-by: SJ Park <sj@xxxxxxxxxx>
---
Documentation/admin-guide/mm/damon/usage.rst | 11 ++++++++++-
1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/Documentation/admin-guide/mm/damon/usage.rst b/Documentation/admin-guide/mm/damon/usage.rst
index ce4e9e4c13276..4024dd4e92979 100644
--- a/Documentation/admin-guide/mm/damon/usage.rst
+++ b/Documentation/admin-guide/mm/damon/usage.rst
@@ -117,7 +117,7 @@ comma (",").
│ │ ...
│ reports/
│ │ producers/nr_producers
- │ │ │ 0/report_type,producer_state
+ │ │ │ 0/report_type,producer_state,addr_start,addr_end
│ │ │ ...

.. _sysfs_root:
@@ -767,6 +767,15 @@ Users can write below keywords for the producer to the file.

- ``on``: Enable the producer.
- ``off``: Disable the producer.
+- ``submit``: Generate and submit a new ``user_report`` type report, if
+ ``report_type`` is ``user_report``, and the producer is enabled.
+
+``addr_start`` and ``addr_end`` files are used only for ``user_report`` report
+type. Those set the address range of memory to manually report . Users can
+set the start and end address of the address range by writing the addresses to
+the files. Note that it is open-end range (``[addr_start,addr_end)``) and
+therefore the end address is exclusive. Reading the files shows the last
+successfully written input.

.. _tracepoint:

--
2.47.3