From patchwork Tue Feb 18 22:37:08 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 13980988 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by smtp.lore.kernel.org (Postfix) with ESMTP id 1C40DC021AA for ; Tue, 18 Feb 2025 22:37:29 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 7CEC82801AD; Tue, 18 Feb 2025 17:37:23 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 72E0F2801A7; Tue, 18 Feb 2025 17:37:23 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 5A87A2801AD; Tue, 18 Feb 2025 17:37:23 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0011.hostedemail.com [216.40.44.11]) by kanga.kvack.org (Postfix) with ESMTP id 3668E2801A7 for ; Tue, 18 Feb 2025 17:37:23 -0500 (EST) Received: from smtpin09.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay03.hostedemail.com (Postfix) with ESMTP id EC410A0C04 for ; Tue, 18 Feb 2025 22:37:22 +0000 (UTC) X-FDA: 83134527924.09.73116DD Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by imf30.hostedemail.com (Postfix) with ESMTP id 5C6B980007 for ; Tue, 18 Feb 2025 22:37:21 +0000 (UTC) Authentication-Results: imf30.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=ZBf8IcQ7; spf=pass (imf30.hostedemail.com: domain of sj@kernel.org designates 139.178.84.217 as permitted sender) smtp.mailfrom=sj@kernel.org; dmarc=pass (policy=quarantine) header.from=kernel.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1739918241; h=from:from:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=RoxhzAY4pjZVxWNgcafc/6u5fubd9E1JTfd1abyPRXM=; b=Sz8aYC9np3UZEmR21n0kXMr0P7479NV/vd0xqcyu7upO1cVLZANPUGgD6I8Bd9GtM7KtAS vCOk0OTFXLOr6AnMMMzjexmgn+WC+YGXPRLa0ozkR6FZbuce6OW5T/lKTrYArwygUbCTSM fW8Kc7fNk6fAaSX/Hoairte8gBsv11U= ARC-Authentication-Results: i=1; imf30.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=ZBf8IcQ7; spf=pass (imf30.hostedemail.com: domain of sj@kernel.org designates 139.178.84.217 as permitted sender) smtp.mailfrom=sj@kernel.org; dmarc=pass (policy=quarantine) header.from=kernel.org ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1739918241; a=rsa-sha256; cv=none; b=ibxKIJFtAP1OYs631ayMhtvIBDto6vfhp8bD8lYom8gZfjjeSCUy/W0nhra+anC1D0moas v3rv4y8K4sLCj+DzFrDUMCOxc2qZTYwC9qASs3hpHbtClL3difWquDHHlBUYHyzENKv4uY KdNMjRv5c5oMGuJDNWm2QSJJKdItL60= Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by dfw.source.kernel.org (Postfix) with ESMTP id 5F8475C62E0; Tue, 18 Feb 2025 22:36:41 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 3A982C4CEE9; Tue, 18 Feb 2025 22:37:20 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1739918240; bh=vUxLfkCpY88Ji5OMZq0cqa7fD684OUmQSZGkIOTWbog=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=ZBf8IcQ7SBqxOHl6shx9kpwOG8zyvVKn1o0yGS+ABt/RZa37ik+go4oxPnyWKBXXw xs63aJ2cPumV1wbfLpy7KOFfanMr5BUOgp6V+iHTBkXUjBduRoCWkgxO2bKS31w4LV 4prXRBiq6SBBTjbeBsqH+NOZL+2UCa5bvvkJDplBtndyufgvthbfBo5vnndYsf0OU7 A6sAcK1F1kBuiOv2jGAZ0sowBt24oJigB08yD4BPGBIFJpxShDFlONutU4CXbalMzd AhDIB54oRkG3FFpDfQtTuc1nMwMTz/lZcZg34sQQ2qeSsrnD5mPVrhZgy7NDXMh2sW FbdbNMwV+XHlg== From: SeongJae Park To: Andrew Morton Cc: SeongJae Park , Jonathan Corbet , 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 Message-Id: <20250218223708.53437-6-sj@kernel.org> X-Mailer: git-send-email 2.39.5 In-Reply-To: <20250218223708.53437-1-sj@kernel.org> References: <20250218223708.53437-1-sj@kernel.org> MIME-Version: 1.0 X-Rspam-User: X-Rspamd-Server: rspam08 X-Rspamd-Queue-Id: 5C6B980007 X-Stat-Signature: f57hbx5r6wg51efta7ib3s8t445933gb X-HE-Tag: 1739918241-882371 X-HE-Meta: U2FsdGVkX19dd4Cy2JpUMZLH2hVlH7fWzY3Q87gSFqf2sJ2VeXthfmcZOWrcSkfedVUyCv+VsSE1pCpZdyKdLasm5isAsGP6Oq3+wiUoOqz28nneiRcpVb4O+0qsAks9zDpbDfbUWcuvIKDACl7pmneoZ8gQy6P/akkvS5Ktvx+G912yVWRXp/hcRMS/0M/d5V8vpOQZUlfg14wMsFeVTAD1nYOVhtwLZqg3G2FR7c2RCYaCfBo7Z25/EtmopEPJbcTfD0xC7AnqVxgMezNTFSw26Inbx8u1Jb52tb8a/X5i4izBX0CHYbTK4r94HY8PsyTW0KN4eQMl7PtDnHGMFQAG/Zd4Of2k11vxLxEPVtSLuGmhHt+BiUAxWEMpdKcQgqF/Aq1PMa6yrQY5I/4Z4xScC/Go0DB2Ga1JQWIBrElMY6gfM5GwWfLXCXjsgaFrg4l3WFh700dildWZKMHRo9kuIo4De0Z+VIbQYIYd+iqtkrPmA0QaTInxoMTFryhRkX5PsQsy6ooStjncm9brDfU1emGVL2eG0KZRwRbYjoKUinvofclLDr7Vi+QPp0Go23jWRNnJC/q6aQBnFTSySvJhXMCkBqTntLTyvXh4vWH59bYi6va3m5L9U7j7DJ6t7omNrdIymWqeL/9Zlgy0/z1f/EOUNucZshm2Eub4oDMozI4q+aMbHcTQ/hRTUtnhuSvA0PI85pw/UT0x1GC+I2uT1ZywxmfB/jlA5zSg1Lr3rnOfY/sV+nKdnIKz67I5jTg81jwxoq9SW2yr9zxwlZkZzyFBYekRltC/7FjP1mvWVQQ1Ub0FiJJAnxnlEzpsD2GNmSnUaAjY3yA48bHaOc8q3q2ntMULFOUkx9XzDKkt5wFtRCHTlv6SZxkI//dsdMkNewpo9KEKeZULmH3Ij5cXbYgxXVia5aSFtiTdTtJrO0e8A0fHsYHJTt/bLnM5KNyBf5R8mMiYkyApATZ AUH8LIfl FmWh9MUCVAco+eKqMEZ9B7smEhqDIPGuyi29t+wgX0LUN0+dXMu+/w9n4Q0/KnvwFMJiRwjzjrDrtlzXxXWc099S6dpbMUOiD6tBXzhiaQLNDEtkVOnXBy8jNqB7/6j9+8Eu7k7nxabq1l/hxiAZm7dS5YJb/K3zIiXLS+FAFyGBRDwxpEfFOqgtYGBJytuVYEjXi67vbgNMmqbK/dOF1Ts+VikYAgk3mo2+Thz7XfjtLuG4= X-Bogosity: Ham, tests=bogofilter, spamicity=0.000000, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: List-Subscribe: List-Unsubscribe: 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 --- 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 `, refer to :ref:`filters ` part of the