From: SeongJae Park <sj@kernel.org>
To: Andrew Morton <akpm@linux-foundation.org>
Cc: SeongJae Park <sj@kernel.org>, Jonathan Corbet <corbet@lwn.net>,
damon@lists.linux.dev, kernel-team@meta.com,
linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org,
linux-mm@kvack.org
Subject: [PATCH 5/5] Docs/mm/damon/design: categorize DAMOS filter types based on handling layer
Date: Tue, 18 Feb 2025 14:37:08 -0800 [thread overview]
Message-ID: <20250218223708.53437-6-sj@kernel.org> (raw)
In-Reply-To: <20250218223708.53437-1-sj@kernel.org>
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.
Signed-off-by: SeongJae Park <sj@kernel.org>
---
Documentation/mm/damon/design.rst | 34 ++++++++++++++-----------------
1 file changed, 15 insertions(+), 19 deletions(-)
diff --git a/Documentation/mm/damon/design.rst b/Documentation/mm/damon/design.rst
index 8b9727d91434..6a66aa0833fd 100644
--- a/Documentation/mm/damon/design.rst
+++ b/Documentation/mm/damon/design.rst
@@ -602,25 +602,21 @@ filters-checking overhead.
Below ``type`` of filters are currently supported.
-- 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.
+- 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.
+ - memcg
+ - Applied to pages that belonging to a given cgroup.
+ - young
+ - Applied to pages that are accessed after the last access check from the
+ scheme.
+ - hugepage_size
+ - Applied to pages that managed in a given size range.
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
--
2.39.5
prev parent reply other threads:[~2025-02-18 22:37 UTC|newest]
Thread overview: 6+ messages / expand[flat|nested] mbox.gz Atom feed top
2025-02-18 22:37 [PATCH 0/5] Docs/mm/damon: misc DAMOS filters documentation fixes and improves SeongJae Park
2025-02-18 22:37 ` [PATCH 1/5] Docs/mm/damon/design: fix typo on DAMOS filters usage doc link SeongJae Park
2025-02-18 22:37 ` [PATCH 2/5] Docs/mm/damon/design: document hugepage_size filter SeongJae Park
2025-02-18 22:37 ` [PATCH 3/5] Docs/damon: move DAMOS filter type names and meaning to design doc SeongJae Park
2025-02-18 22:37 ` [PATCH 4/5] Docs/mm/damon/design: clarify handling layer based filters evaluation sequence SeongJae Park
2025-02-18 22:37 ` SeongJae Park [this message]
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20250218223708.53437-6-sj@kernel.org \
--to=sj@kernel.org \
--cc=akpm@linux-foundation.org \
--cc=corbet@lwn.net \
--cc=damon@lists.linux.dev \
--cc=kernel-team@meta.com \
--cc=linux-doc@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-mm@kvack.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox