[RFC PATCH v3 31/37] Docs/mm/damon/design: document threads type sample filter

SeongJae Park
2025-12-08T06:30:37Z

Update DAMON design document for threads type access sample results
filtering.

Signed-off-by: SeongJae Park <sj@kernel.org>
---
Documentation/mm/damon/design.rst | 5 ++++-
1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/Documentation/mm/damon/design.rst b/Documentation/mm/damon/design.rst
index 9a4679de437f..4c6d83263a7b 100644
--- a/Documentation/mm/damon/design.rst
+++ b/Documentation/mm/damon/design.rst
@@ -148,7 +148,7 @@ the page protection in a way similar to that of NUMA balancing hinting faults.
Then the page fault handler reports the faults happend by the installed page
protection to DAMON core layer. Compared to the accessed-bit based one, this
approach gives more information to DAMON, such as the access-generated
-CPU.
+CPU/threads.

``paddr`` uses :ref:`accessed-bit based check
<damon_design_pte_accessed_bit_access_check>` by default, and users can change
@@ -314,6 +314,9 @@ Below ``type`` of access sampling results filter are currently supported.
- cpumask
- Whether the sampled access was generated by a cpu that included in a
given cpumask.
+- threads
+ - Whether the sampled access was generated by a thread that having a thread
+ (task) id that exist in a given array of ids.

.. _damon_design_age_tracking:
--
2.47.3