Docs/mm/damon/design: document attrs-only monitoring

Update DAMON design document for the attributes only monitoring mode.

Link: https://lore.kernel.org/20260710134651.18084-18-sj@kernel.org
Signed-off-by: SJ Park <sj@kernel.org>
Cc: David Hildenbrand <david@kernel.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: Liam R. Howlett <liam@infradead.org>
Cc: Lorenzo Stoakes <ljs@kernel.org>
Cc: Michal Hocko <mhocko@suse.com>
Cc: Mike Rapoport <rppt@kernel.org>
Cc: Suren Baghdasaryan <surenb@google.com>
Cc: Vlastimil Babka <vbabka@kernel.org>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
This commit is contained in:
SJ Park 2026-07-10 06:46:46 -07:00 committed by Andrew Morton
parent 2430a8d517
commit f10489d2ef

View File

@ -316,6 +316,26 @@ Another way to do this for higher accuracy is using :ref:`DAMOS filter
information in page level. But, because it is operated in page level, the
overhead is proportional to the size of the memory.
Data Attributes-only Monitoring
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Data access is the primary monitoring information for DAMON. Hence it
:ref:`adjusts <damon_design_data_attrs_monitoring>` regions using the access
:ref:`counter <damon_design_region_based_sampling>` (``nr_accesses``). In some
use cases, however, users may want some of :ref:`attributes
<damon_design_data_attrs_monitoring>` to be the primary information.
Data attributes-only monitoring mode supports this use case. For the mode,
each attribute probe has their priority weight value. Users can describe by
what combination of the attributes the primary information is decided, by
setting the priority weight value. If the total sum of the weights is not
zero, the mode is enabled. The regions adjustment mechanism uses the weighted
sum of the :ref:`probe hit counts <damon_design_data_attrs_monitoring>` instead
of ``nr_accesses`` in the case. When the mode is enabled, access monitoring is
automatically turned off. The access counter (``nr_accesses``) will always be
zero and not updated. Hence the mode is called Data Attributes "only"
monitoring.
Dynamic Target Space Updates Handling
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~