From patchwork Fri Apr 26 19:52:44 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 13645329 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 A2EDCC04FFE for ; Fri, 26 Apr 2024 19:53:15 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 99DB06B009A; Fri, 26 Apr 2024 15:53:09 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 94BD36B009B; Fri, 26 Apr 2024 15:53:09 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 751BD6B009C; Fri, 26 Apr 2024 15:53:09 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0013.hostedemail.com [216.40.44.13]) by kanga.kvack.org (Postfix) with ESMTP id 56C316B009A for ; Fri, 26 Apr 2024 15:53:09 -0400 (EDT) Received: from smtpin12.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay05.hostedemail.com (Postfix) with ESMTP id 0516E407CC for ; Fri, 26 Apr 2024 19:53:09 +0000 (UTC) X-FDA: 82052731698.12.A0F2E92 Received: from sin.source.kernel.org (sin.source.kernel.org [145.40.73.55]) by imf09.hostedemail.com (Postfix) with ESMTP id 2965314002A for ; Fri, 26 Apr 2024 19:53:06 +0000 (UTC) Authentication-Results: imf09.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=FaY7xpWf; spf=pass (imf09.hostedemail.com: domain of sj@kernel.org designates 145.40.73.55 as permitted sender) smtp.mailfrom=sj@kernel.org; dmarc=pass (policy=none) header.from=kernel.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1714161187; 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=FUsxGwmTJmnXa2I6dVUNImeXfxXkmfH4l07M6DVjAxo=; b=dbGfhR7l2jMN4r/JEAL+CWdsGbYAj7JoApIdgxbxXBJSRhG9tluo8XSIUzavh5bXUjDyiH 8n3aE2It7hFDKIZydVZKY4JNkaotuUBiVC5iFLSd4lmOd4N0IHHoTgH9rwpsIZSYs57Eyb Oqu26e16M7BNqbKzVuRgKNUNFeKX7Uk= ARC-Authentication-Results: i=1; imf09.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=FaY7xpWf; spf=pass (imf09.hostedemail.com: domain of sj@kernel.org designates 145.40.73.55 as permitted sender) smtp.mailfrom=sj@kernel.org; dmarc=pass (policy=none) header.from=kernel.org ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1714161187; a=rsa-sha256; cv=none; b=5GyRwz3oVhcLaKS5VQoMZMRI+nVenqUi7fEaR2T7NiZNBXpRiZnmwonOEGPZ8qiCtGLW0z qvXI8MWnK1YJTpfvSPXEyNRk/HWF/q3TdF5OIfEJSdcACiH6dQjSdRPaBQ6efqgZHlxteD kzczAhygSTKxmf6p4gy/QJojAGQkpuk= Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by sin.source.kernel.org (Postfix) with ESMTP id F3621CE1D0C; Fri, 26 Apr 2024 19:53:03 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 11159C113CD; Fri, 26 Apr 2024 19:53:03 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1714161183; bh=Dn52cDE5Pk1z+Ex2+NSRLPE8W1EnK4AAtmH09ziQ5Go=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=FaY7xpWfrq2qjeYXOwwOAZVETK3xRZ4BxENUObbcz7u+jRxkYrBEvm858VQn6g3W7 Vekg9u8ya7fwc0J4yH0UOxjzG6Np4hOXm+/eQoHQTN+mVOAaxSNhpFobPivRMWZk+0 JuamddyfKk4YlShNuwYzemkcyyidfA0P/kdAWMRGBjCvHKAetm3nVO91ytlCvyPQFA Ugrhr/lf5hM7Q5BInN/rFbGaTqlMOiNKhBOYrPamVy11SiKWIZr/aP//bGpfDO3Zmu gQuVQ1NTskmEnwjxWxDMtkPsZOhqTng13jmR1COz8BfNuKdpCD8esBcuhvZ3RDnvOp qf21CwHedF6lg== From: SeongJae Park To: Andrew Morton Cc: SeongJae Park , Jonathan Corbet , damon@lists.linux.dev, linux-mm@kvack.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH 5/7] Docs/mm/damon/design: document 'young page' type DAMOS filter Date: Fri, 26 Apr 2024 12:52:44 -0700 Message-Id: <20240426195247.100306-6-sj@kernel.org> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20240426195247.100306-1-sj@kernel.org> References: <20240426195247.100306-1-sj@kernel.org> MIME-Version: 1.0 X-Rspam-User: X-Rspamd-Queue-Id: 2965314002A X-Rspamd-Server: rspam06 X-Stat-Signature: bhkkp8gaye9twdeadnniqqgxtotty9ca X-HE-Tag: 1714161186-960967 X-HE-Meta: U2FsdGVkX1+7fb6ozjnJOH009WTks2tCX7jHiyGcnCS59IkTJKSeVvwVILa0GCwAKLaDBiaTzwUK6U9qXtNsdBzAcARCpYaqMrBmBrqryjG92PsEq8A8uQROG4sWjfWg/bO+hCHmbsSSaVaOXVvTrX774OTqh7Z8sKfP9weAGNOFwn7u2B+fDs0NE8krmUHNGnCkQiItvq1ZTM95ofD8F+iqxRbieBcUk3ZaBJ/L36CDSK3bePodCfWqCK8HZqA/lmka7ZxcjPxC/5doYy+ud3afsHEKPZPoh8VK1tVIdPTvBZYacTtdeP8WIiVql8uIrTSoR8rUOC1M0ipXuhcZGQ3jj978uklbQtwCTWyWN+UmUR0AmXYdOs/skA254dOvKqiVE1REiFRKKxwoAAoVmBk87mOrFMojOnN21tVg8Wfdk0sHymUDpH5CAxyPaHqhKALfrdBcDJLgUAgAzlfhXZuOQpGcOPFTzT+pt7JBL+f0Sb9jgZty/aTmQAKdobAigzibPVsNRMgTqH1vgGyDZAYa3sL67NV0Q45JZZNmQeSZUJHC5CkisbkcaGJGBXYHELa7q3UC/ZoDsHhXH/Jojhxhr+y/hrCoRJtdntUI6cbSCyU+hTamX4/P45eq/8zyTLmqKxPhJqQEhNcp8IJtsgnJ8nk31RPrey+tRdh4cb5q2f02NzHCJ2estYr42sDtaXqAb6TDUiIG+AWJf0e1hIstHD07BepY/FvW19O5NXvBZviQZTJq5/LCI68+3aiLGBVoOIWbj921PiLZXfoAXW3c9lFEZyh9+6xzHyODbIsDCIXG+g7DETShUlevBJuIlYGYSSNBEu5w6Xi+4rfRFB2zZeic/aliNCbf72LU5+wK8xM9U6DxAJzc3vj+12N/RVK86Sp5Tw+BFY0I6YZjC5YL/dzpderv496irSc9BVM= 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: Update DAMON design document for the newly added DAMOS filter type, 'young page'. Signed-off-by: SeongJae Park --- Documentation/mm/damon/design.rst | 20 +++++++++++--------- 1 file changed, 11 insertions(+), 9 deletions(-) diff --git a/Documentation/mm/damon/design.rst b/Documentation/mm/damon/design.rst index 5620aab9b3850..f2baf617184d0 100644 --- a/Documentation/mm/damon/design.rst +++ b/Documentation/mm/damon/design.rst @@ -461,15 +461,17 @@ number of filters for each scheme. Each filter specifies the type of target memory, and whether it should exclude the memory of the type (filter-out), or all except the memory of the type (filter-in). -Currently, anonymous page, memory cgroup, address range, and DAMON monitoring -target type filters are supported by the feature. Some filter target types -require additional arguments. The memory cgroup filter type asks users to -specify the file path of the memory cgroup for the filter. The address range -type asks the start and end addresses of the range. The DAMON monitoring -target type asks the index of the target from the context's monitoring targets -list. Hence, users can apply specific schemes to only anonymous pages, -non-anonymous pages, pages of specific cgroups, all pages excluding those of -specific cgroups, pages in specific address range, pages in specific DAMON +Currently, anonymous page, memory cgroup, young page, address range, and DAMON +monitoring target type filters are supported by the feature. Some filter +target types require additional arguments. The memory cgroup filter type asks +users to specify the file path of the memory cgroup for the filter. The +address range type asks the start and end addresses of the range. The DAMON +monitoring target type asks the index of the target from the context's +monitoring targets list. Hence, users can apply specific schemes to only +anonymous pages, non-anonymous pages, pages of specific cgroups, all pages +excluding those of specific cgroups, pages that not accessed after the last +access check from the scheme, pages that accessed after the last access check +from the scheme, pages in specific address range, pages in specific DAMON monitoring targets, and any combination of those. To handle filters efficiently, the address range and DAMON monitoring target