Commit edab6ffd authored by SeongJae Park's avatar SeongJae Park Committed by Andrew Morton
Browse files

Docs/mm/damon/design: categorize DAMOS filter types based on handling layer 

On what DAMON layer a DAMOS filter is handled is important to expect in
what order filters will be evaluated.  Re-organize the DAMOS filter types
list on the design doc to categorize types based on the handling layer, to
let users more easily understand the handling order.

Link: https://lkml.kernel.org/r/20250218223708.53437-6-sj@kernel.org


Signed-off-by: default avatarSeongJae Park <sj@kernel.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Signed-off-by: default avatarAndrew Morton <akpm@linux-foundation.org>
parent 4a4d8e79

Documentation/mm/damon/design.rst

+15 −19
Original line number Diff line number Diff line
@@ -602,25 +602,21 @@ filters-checking overhead. 


Below ``type`` of filters are currently supported.



- Core layer handled

    - addr

        - Applied to pages that belonging to a given address range.

    - target

        - Applied to pages that belonging to a given DAMON monitoring target.

- Operations layer handled, supported by only ``paddr`` operations set.

    - anon

        - Applied to pages that containing data that not stored in files.

    - Handled by operations set layer.  Supported by only ``paddr`` set.

    - memcg

        - Applied to pages that belonging to a given cgroup.

    - Handled by operations set layer.  Supported by only ``paddr`` set.

    - young

        - Applied to pages that are accessed after the last access check from the

          scheme.

    - Handled by operations set layer.  Supported by only ``paddr`` set.

    - hugepage_size

        - Applied to pages that managed in a given size range.

    - Handled by operations set layer.  Supported by only ``paddr`` set.

- addr

    - Applied to pages that belonging to a given address range.

    - Handled by the core logic.

- target

    - Applied to pages that belonging to a given DAMON monitoring target.

    - Handled by the core logic.



To know how user-space can set the filters via :ref:`DAMON sysfs interface

<sysfs_interface>`, refer to :ref:`filters <sysfs_filters>` part of the