From patchwork Tue Feb 18 22:37:04 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 13980984 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 8D514C021AF for ; Tue, 18 Feb 2025 22:37:19 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 0C6992801A9; Tue, 18 Feb 2025 17:37:19 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 04EB72801A7; Tue, 18 Feb 2025 17:37:18 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id D95822801A9; Tue, 18 Feb 2025 17:37:18 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0017.hostedemail.com [216.40.44.17]) by kanga.kvack.org (Postfix) with ESMTP id BC2412801A7 for ; Tue, 18 Feb 2025 17:37:18 -0500 (EST) Received: from smtpin24.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay09.hostedemail.com (Postfix) with ESMTP id 7FD5E80692 for ; Tue, 18 Feb 2025 22:37:18 +0000 (UTC) X-FDA: 83134527756.24.30929F7 Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by imf23.hostedemail.com (Postfix) with ESMTP id E5E1A14000E for ; Tue, 18 Feb 2025 22:37:16 +0000 (UTC) Authentication-Results: imf23.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=sWv28ne6; spf=pass (imf23.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=1739918237; 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=MwND0qElm65VwAKppYM24qmOWGLc0pn+y53SkeHziV8=; b=2d9os/ubfDd1tzTzGJZXP7txBwFcL6EKPiWqvBuIjEkDfA1centMGm9Cwtw/mI1OilJ9H6 EPO14aiVwc59EjnTcH48Ikm35ZBNd/HIi6r+3Zy8CVCCaeSH17zf5YAmqsvPSMAY0RsozS qBMbcZaj5XnwoFftg40FTwvTCYhXnbI= ARC-Authentication-Results: i=1; imf23.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=sWv28ne6; spf=pass (imf23.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=1739918237; a=rsa-sha256; cv=none; b=p7URL3KRkEBR2HscVHau2AE3VJtgGxgQHVZudo/bB6tf+09m/ltW9pkgJey8qwe5AYH3jP uiIr08V/ZfYzlSt5cvb+dkYNqrwNic954f78MqW0MiZfbP+i437JYAGwWbOKPb7gHe9fTp 1tKA1BgUEE6xo8OKvby57dkx3+6WkDQ= Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by dfw.source.kernel.org (Postfix) with ESMTP id CC7D95C62E0; Tue, 18 Feb 2025 22:36:36 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 90B99C4CEE9; Tue, 18 Feb 2025 22:37:15 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1739918235; bh=oVrTdf5C/EBPIaqFakiqgRImT9fNI+SmRrYJWLyvJAg=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=sWv28ne6lJmgoEZuJmn/3XVtEE1nWDasnYx3PPO0nWlPF4XtkkXvBUfHx7r8Oyd9y usAKH6EF284Tx7bGBB43hO4EcKKrGcNGj+Atk7Am8nYQ5nweYjyFgufIFsrx3N3Lv0 jveAIA0qL16c/YBXdLEGDjmhxdWSLztB8ch5zg08Pb2Z4gfkI65BisKvY0hWA8EgUz 6ehh3lHk+sWLiZsvrgGmA0oLp+l/JwauIRWQzeGQrBKzjlatB+DEUzZCwT2UlU2+VE 3GBgNt6lAciFyVjl1IhvOVm0yTtowBAsvpQfZroxv/Nmf1UptD4c4PtP5WHIF4+Rtn fJOAlJT+C1UUA== 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 1/5] Docs/mm/damon/design: fix typo on DAMOS filters usage doc link Date: Tue, 18 Feb 2025 14:37:04 -0800 Message-Id: <20250218223708.53437-2-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: E5E1A14000E X-Stat-Signature: b1u93aep7p4kjkty88m4t5xeigs7zbb5 X-HE-Tag: 1739918236-951812 X-HE-Meta: U2FsdGVkX1+rsM98ItKwNWH2lC3Qkk2R2ptk+PmZ+q1biRhsSKc9F7wHOSIlRXAxqxn/eTJZaMty4SgZmr3Hjqoks3zwAaJlnLbZ1w0B1DHwbRomwcRJLeisYk951A4oWaZ+DKIFpQZws2rBO+L3AgjArklEUxeSna1/DxnQyowlmuCa+zwbZtItMnREejRkOt1dPgBX5odk5kfzN1cBY971lubBhbIGiclvkflFJeRzLnReMY6Lgi29oehcZNxs1n2vVqB6+LWuCH7c/MxFZD55vU4hHH6VZJVhpJXHZ9QRfgverlheG4fDB3EvKyzwH/9bN28+7aI56ZTkWf1t1sUye/vBdvpfGRvUXrKAqnEejfU+0TmjZ9NA3IUe9K1XimPxI2sOjRrRbWgnyD6sqPQwU3QL9UJJlOFQCxggJZATDPOYHEC+WQfQTCh0UNteo46uaeOx9s7mcwdEI3UeOSHB/j+M2433gN07xIFd6HMcm0HonMqoDPjaUaraSjCQ4xIQ4/HCxkZF7WVBLFX1SQVXgp1jBB56woj8dqIyOtOpRupslLihvAwwazs0BTKj3p6dIGjmUe8We2CSXrsYgX2E2lgo7KGqi/zp241pxM6+658wkjJPsDlrqcMDtQrjZDt9kgvQBmMfbyZkCksDPEL7bm0A1xX2iiN6Nxz0KS6nM1op1I5m0ErtTNXSuctQ29p0YSrHwIcJC3y+RT/PLF26mJjfNHPyS4n8sbKXltaC6SDKIDIK13bbCXihTCBSoCrT/xFZb9Z/45RIZIvAziWEQO51xO+8F2qhOuW0NBRe702N5lCAjegXDuDEoFsFQQc9gB2cs4qv4/C1bctsNqasof1/1m6Oa5vqHWxPCOLU1+QbMLiWv9yBwIWj52Q75rEQAEeH/ucrMMlNSLvZPpY4jNChHhuKceZjA10PvsdAMP+SwrHJDt2k5qE6IS28NPmD4txrmFLK0yPQz8z VWtD3MXT xfkeMnbU0lHpZ29gbZSLrm8o8foerS+jVr8ReAU2yFBXJ83H7ykNnRAngSJLicREinVyi5J95KsDVipQz77oBr0SK79bQeT/aU3XwNZAqPQ4VfSQ7OmUlff46mD47rAzIl+pmibzXJ3vmnKk/3efBdLmXRR3aUPDZ8gPFJ1Cj6WE35d4uSftr25A9SmcL7WpJka7laSLTvh8exEsX3xrgcGx4H38QPpN6QcHqSLuwN6b7WQw= 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: The link from DAMOS filters design doc to usage doc has a typo calling filters as watermarks. Fix it. Fixes: d31f5626a0e1 ("Docs/mm/damon/design: add links to sections of DAMON sysfs interface usage doc") Signed-off-by: SeongJae Park --- Documentation/mm/damon/design.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/mm/damon/design.rst b/Documentation/mm/damon/design.rst index e28c6a1b40ae..12ae7e1209c8 100644 --- a/Documentation/mm/damon/design.rst +++ b/Documentation/mm/damon/design.rst @@ -617,7 +617,7 @@ Below ``type`` of filters are currently supported. - Applied to pages that belonging to a given DAMON monitoring target. - Handled by the core logic. -To know how user-space can set the watermarks via :ref:`DAMON sysfs interface +To know how user-space can set the filters via :ref:`DAMON sysfs interface `, refer to :ref:`filters ` part of the documentation. From patchwork Tue Feb 18 22:37:05 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 13980985 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 798B9C021AD for ; Tue, 18 Feb 2025 22:37:21 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 1B4FB2801AA; Tue, 18 Feb 2025 17:37:20 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 0C53F2801A7; Tue, 18 Feb 2025 17:37:20 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id E34ED2801AA; Tue, 18 Feb 2025 17:37:19 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0016.hostedemail.com [216.40.44.16]) by kanga.kvack.org (Postfix) with ESMTP id B22C02801A7 for ; Tue, 18 Feb 2025 17:37:19 -0500 (EST) Received: from smtpin08.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay01.hostedemail.com (Postfix) with ESMTP id 66E3D1C7917 for ; Tue, 18 Feb 2025 22:37:19 +0000 (UTC) X-FDA: 83134527798.08.F96067A Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by imf13.hostedemail.com (Postfix) with ESMTP id D216B20002 for ; Tue, 18 Feb 2025 22:37:17 +0000 (UTC) Authentication-Results: imf13.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=mytcYbpB; spf=pass (imf13.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=1739918237; 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=S+Il6HFvadJtBIG0Sodxg2XGWZjfybrclnpXlUb2JDs=; b=dihWYmlpc40i28UPrC2NM4Yy60Avtr2P2Spw033D9ki1OIvyUtuGrv6+4O43bVMJjM6J/F LZavBpPyKhnpWes6kdVOSsGOv9JaO7YlSrrcG1P+uu0nZKL25j25wLNAcbVZauOIUTidCF oaBW1L7t7r6xW2X4Yp0YQWFl0MpYA3c= ARC-Authentication-Results: i=1; imf13.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=mytcYbpB; spf=pass (imf13.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=1739918237; a=rsa-sha256; cv=none; b=b1t8hPG6534Y8ADvlcgkqeG6jWA7vpt13W9jx26z33b+UOqGVCUCHCKfA9l8r8o+0yKjvk 96QTYCz2jI/3wK1A4j/Ay0EVwEK1GiHMWi6Io1D2bXeeQCEfmgAXnie1eHlvQqq7km85rf n/scOoNI9yNzz5IbFxxHiCkpLMKEEuk= Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by dfw.source.kernel.org (Postfix) with ESMTP id D96735C62EA; Tue, 18 Feb 2025 22:36:37 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id BC197C4CEE6; Tue, 18 Feb 2025 22:37:16 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1739918236; bh=yF1LvomTuLrF1Mrz41dAsbpRkpACzGsaDPNlm98lWpI=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=mytcYbpBPC7VI/ZarhrxpedSk5sHvFNBVYyrEcfA9Rsaal8g4HwuPOAWKWF22iO6Y zczpBzIhL5Lrq+hI1hi2PiCKeaIYuraCFa0xJv2lDoRy9Gu+V2uc4i+MC0vvHDq6Yt fx7rd0qVHoAGrvhf+BjGKzd/CNgr14hmevFeDNog/U1j3s6ZbXTfGlX66Su6vMua32 fvXTxnM+Qb4Kwl5vN3NJqZ/o1FrfUYjiUvQDqUewmqpoYFjg6M8Nr9qWcZ8B04as/K 0iYVVbIWY92VMFcU+1rOH/NMaSTtnpTv1yq0H8KJZnRRnkPv+2ib7NRRIzyQs7H6bi AeBqGfJgAeqOA== 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 2/5] Docs/mm/damon/design: document hugepage_size filter Date: Tue, 18 Feb 2025 14:37:05 -0800 Message-Id: <20250218223708.53437-3-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: rspam11 X-Rspamd-Queue-Id: D216B20002 X-Stat-Signature: 81z8ps3ikj5urbt9p78oztmy4m9chzcr X-HE-Tag: 1739918237-106673 X-HE-Meta: U2FsdGVkX1+EpSWgCepghCoAKRaKfHiT37ksD8PBo6wNuvAaBfkamyE57OVQId52OEtB/3jSumQ1+AALLh2NqE684rrPW3bX3eD0shzpMUN39t42WHoU0M3fxhr2sLj615THfQd34pZHh/EVNf1fmdq68/R0qg+uATyYZmjOy+oUyPuHLV1HLg5ZedQZZpIPNT9hJfADrIuo05/wXsDvpa9oLkvaCWjKL/YyrL5Y/8+svNwJMv+1t6R03MHoCS22mGaOxGfZ1XlTUP+G6pIjtcPcs0tYZad54IY1BTIFOY9c56ot7t3cjhSRK9MRiff/hwJoD6Hl+GxJJdQXAlJhCJhmD2ytRvx9cZOkcN78Ryu/CeiNOfZ40oWo0iTx7GA6rD5aG40FVr+BMOcWWNprGBDwZxScAQLZSIXFh6rnwAIeIRu9f1AKJ0TlA6QevAZgp2WKsG8P49X8rzleSr5wyow6PFUWjEeEB3Pgi+vZ8fl5pHl2YAbV+UfAYyMjJBISDnFyQut91AE8YjJ5mA4Tw1ftT4XXss7PdmerFs568uEHjRePHvikHwOSgW0MQn82k80Fnw5gYJAcNUR0kbaYMcJWsXSrCiUMPeNJQGPDTFNktGu/JHC258ZJ988+93+4LWQh+HTGhlV+H1XM5MGxW+kjCk2QROzNry9V8CrMdv16NLM29CH8f7KLTAPZoTH/2W6GbX76ZhIoi6DiGtF50McicPgPO52EY8w+6c5ggBoS/F1PddU692aN5GNCIEv10GoiuaNMFCDgO8iTbhzsUTKd7TkbqW5ztitkKTUZgE3cp2hZGZ77IpsNpIlYWU01Xd62sY8DhKh+0VsnLdTsQR5Bh/uxu2du4t8qvAKJ/XcpyDJUWW3pgkVPYhrDHLgt8WjsD3ShQFRFtNZeK//+fXL9zSn/RaLKQQ7rZVV1M0WfVSB4nfKlh06vbsS4/7Ie6AV7jvLNb0puTrOTzMD p8wt7ODq H6cE66CJTQSvXbGY94B7sVPWdPfMcfA3J29u5JBqbmmwf7Xz047zmmUiWzauDCZN4nTVxHCKesm+SEz/c0u4Sx6hg567PW9/fDjTsLgLqNvY9LGkYK/1xsIiDUjnDoOSNhIeIn1LUhxx3zsXkrOGmis2q00bjsAi82R1mSV/GeMNY3XBl52UJzsGXidFnTL90w7jT4S6y5fLjISGi0xtdtFpagd3H2YP3/dOk1unar/+ppV7+i82SSKnBLYBwf87jJ39CO9CDOuD0sNC4IiVCFxuREncZo7Ot024C9IP+XbvNFFHMrEHiWPPD4g== 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: 'hugepage_size' DAMOS filter type is not documented on the design doc. Add a description of the type. Signed-off-by: SeongJae Park --- Documentation/mm/damon/design.rst | 3 +++ 1 file changed, 3 insertions(+) diff --git a/Documentation/mm/damon/design.rst b/Documentation/mm/damon/design.rst index 12ae7e1209c8..a959c081bc59 100644 --- a/Documentation/mm/damon/design.rst +++ b/Documentation/mm/damon/design.rst @@ -610,6 +610,9 @@ Below ``type`` of filters are currently supported. - Applied to pages that are accessed after the last access check from the scheme. - Handled by operations set layer. Supported by only ``paddr`` set. +- pages that managed in a given size range + - Applied to pages that managed in a given size range. + - Handled by operations set layer. Supported by only ``paddr`` set. - address range - Applied to pages that belonging to a given address range. - Handled by the core logic. From patchwork Tue Feb 18 22:37:06 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 13980986 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 EA446C021AD for ; Tue, 18 Feb 2025 22:37:23 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 4716D2801AB; Tue, 18 Feb 2025 17:37:21 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 3AC052801A7; Tue, 18 Feb 2025 17:37:21 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 13C422801AB; Tue, 18 Feb 2025 17:37:21 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0017.hostedemail.com [216.40.44.17]) by kanga.kvack.org (Postfix) with ESMTP id E278C2801A7 for ; Tue, 18 Feb 2025 17:37:20 -0500 (EST) Received: from smtpin16.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay07.hostedemail.com (Postfix) with ESMTP id A27F0160668 for ; Tue, 18 Feb 2025 22:37:20 +0000 (UTC) X-FDA: 83134527840.16.A471197 Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by imf18.hostedemail.com (Postfix) with ESMTP id EB7DB1C000B for ; Tue, 18 Feb 2025 22:37:18 +0000 (UTC) Authentication-Results: imf18.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=QuI8Tq0b; spf=pass (imf18.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=1739918239; a=rsa-sha256; cv=none; b=MFNMSRnLRbsTS5Hd5VpJvtNoukIfTBl/aomWDs6bEryLxkn1PTDz4rEC0Olukt2xy8Ngel iuuzkWg1KnWQbQr6ICf/nfDqc6e0ebh2dn4LodY/l+NXquaYQnR8GG3JrmY/CwLdWqJjN/ oTylh6nXYnru3HAXPC2RL8uztYJbtzY= ARC-Authentication-Results: i=1; imf18.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=QuI8Tq0b; spf=pass (imf18.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=1739918239; 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=gQPCcIMAVzN6csn9KRl4aX+Hhi/ZR9j+gNAv60jWMjA=; b=ykoLczZbxVqNnbTWcGuI88FMdgF3zUeAC/VX1w5Rvtwivc1cIUWwN1FI/KUa9sHvxe3xAG uxeNsvtWLQUva6cnx2iaipTgWnVMJzS1TqeBGfMZfU0QXfQUNST389fDYTa5xSHutWMT6D MZjvkvVhD2hvMVbsxaEXxYTaq1tjI7Y= Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by dfw.source.kernel.org (Postfix) with ESMTP id 057BE5C62EE; Tue, 18 Feb 2025 22:36:39 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id DB00BC4CEE2; Tue, 18 Feb 2025 22:37:17 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1739918238; bh=OOoII5/zyMHQ8WDLAouq/qJ5GMbnfrXAVmpEUBHSZpQ=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=QuI8Tq0ba4foWWD4lvXl4DYdj4Krxz2z/eD4csGR4OWL6PUQWFY5sHuYZM1mu8OAZ uVtiaEI4a81O91DCCHk24hMhtS5SwGzxHgfkMAKa1PkPkCPjeajTIVUuQ1BfkJdx4f gCpm3Lv3Zd1Ma2xHWptxpTpftBGLzJbT+SW7AGXoKTgyxr9uAm0rmzv4KXAToX6LMN OX2CLPygyF01mp3R/MAIxD83zI3dCeVG6vGvKPgWUpn15+2IuBk9vkwtmmxBhA5TiW rEj6XaSC5JH1+xpegU2aIofXYTsQyRkCvNXLRTtsqg0VPzQVS0AHzdQE4zrFXzeHc7 0UgHS6oLynQCQ== 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 3/5] Docs/damon: move DAMOS filter type names and meaning to design doc Date: Tue, 18 Feb 2025 14:37:06 -0800 Message-Id: <20250218223708.53437-4-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-Rspamd-Queue-Id: EB7DB1C000B X-Stat-Signature: p7kwcujjqcaok9rsaji7pt5mstz8fybb X-Rspam-User: X-Rspamd-Server: rspam10 X-HE-Tag: 1739918238-603105 X-HE-Meta: U2FsdGVkX1+Z9wnYvsKeQch6VQOTbKFU1vGzzDgtRPT2dJUNOflBnb+MQT4ZmwDZNT68juHuBtIfAG36vrnn09EFI89R9Oh2/O37CcOc1sbSSWJpz+/DuL7oUnTrtD8pJKzdfsRle+PJeXclvg0H139njQTh8MtXOUqsO6RzE+UvAq5iN97oXYRHJM8XGLEuHDe8VD7UTTc7JpOBakIwQZR55GqtZnvjK7abtNKrMXqQl46Rt4beJwaUaHJww3xu7zVHrWJ76AEJxczydFulWbuviqoxNI52JjlfFPtP0U4Ge+kTQDR1KkJD97y969FRSoYqG82x8awmcDWSMqcn2e2nEpASo5qdypq+nkKd4zTty88YsKBT6TdKBmhX9E9RKgkRbVzPWf7aoK7bp8sjnzvdTokxy6/N2aeVSHC9iQH8EeR0qyqD9Ene8WGDIsNBaeA0ZRQnp1kIJUWfhPTJRnbWM5SKnMf1sYg3nIKJBfaSME3eTEElrnDSTgX23cAavGsG/gDEH6egtnbtO7LnL/WmaMXwB7bt5AsPfyAwHUOoUd+7vqvLTEbKxBl/UupbgVSLNVIjwaJIVLrIM821jYNR4nG56fqpUF+pbZDgAMPMe6xLjUFgmcRIOjzpJykJCJem/zD+3Dq6CXtTlS8IJMShR93e4TeEJpRlQid8bVPaVSWUqKd6AE/MYAdFl8/bFH4+dKCIl3ifDeWjab0oiSw3qmbkRXh6HEKMdstIInwXZtSM8RG7PMuejxvvcQSpWa+VlU+/3jjEk5ZYwbVCyKhC3fMa6+YklqH2t10U6aNqy8XkCoyqBwL8+BMJjE/yFjt1nJWmFrg3RoRrbajIucM8Lsb17Zx2IKhqgJOHzs2v431ggDLbP/PjJ6lymxKPlf6G22mwWS6I85cAY66eqzxjOKxy3WCd6UqQaJ7rXXtCtzZQ7xW0WJF5oSUSAVD/u1ltpqgbDOBAFPtA8IP oyELGl+3 5Ad6I2rV+TfZ+ENZ2gqB+uEEPipqQ9So33ScoEFA07sdNsZr514irtRWsu1H3M4A7ceEMLu4zdk9aYdfqw2x4p/V60C05dP6/mfPzKJX0qUZO2JYWvpG9180XOuBmYIUuPRU5btFOnrkVWAuygWlKJfx+/R5JRPHrKvbnN9Ni1GBjO8KK6wuqGlGXyxXqJdAx8oXJkuIclw0PmZd9TbrP/cvwQXJpIFuj4sQ4r2ax5iFwfuA= 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: DAMON sysfs usage doc is describing DAMOS filter type names and their meanings in short. The design doc is providing the short meaning and detailed descriptions, too. This is unnecessary duplicates and confuses where to document new DAMOS filter types and features. Move the details from usage to design doc. Signed-off-by: SeongJae Park --- Documentation/admin-guide/mm/damon/usage.rst | 28 +++++++++----------- Documentation/mm/damon/design.rst | 12 ++++----- 2 files changed, 19 insertions(+), 21 deletions(-) diff --git a/Documentation/admin-guide/mm/damon/usage.rst b/Documentation/admin-guide/mm/damon/usage.rst index 51af66c208c5..dc37bba96273 100644 --- a/Documentation/admin-guide/mm/damon/usage.rst +++ b/Documentation/admin-guide/mm/damon/usage.rst @@ -408,21 +408,19 @@ in the numeric order. Each filter directory contains nine files, namely ``type``, ``matching``, ``allow``, ``memcg_path``, ``addr_start``, ``addr_end``, ``min``, ``max`` -and ``target_idx``. To ``type`` file, you can write one of six special -keywords: ``anon`` for anonymous pages, ``memcg`` for specific memory cgroup, -``young`` for young pages, ``addr`` for specific address range (an open-ended -interval), ``hugepage_size`` for large folios of a specific size range [``min``, -``max``] or ``target`` for specific DAMON monitoring target filtering. Meaning -of the types are same to the description on the :ref:`design doc -`. - -In case of the memory cgroup filtering, you can specify the memory cgroup of -the interest by writing the path of the memory cgroup from the cgroups mount -point to ``memcg_path`` file. In case of the address range filtering, you can -specify the start and end address of the range to ``addr_start`` and -``addr_end`` files, respectively. For the DAMON monitoring target filtering, -you can specify the index of the target between the list of the DAMON context's -monitoring targets list to ``target_idx`` file. +and ``target_idx``. To ``type`` file, you can write the type of the filter. +Refer to :ref:`the design doc ` for available type +names and their meanings. + +For ``memcg`` type, you can specify the memory cgroup of the interest by +writing the path of the memory cgroup from the cgroups mount point to +``memcg_path`` file. For ``addr`` type, you can specify the start and end +address of the range (open-ended interval) to ``addr_start`` and ``addr_end`` +files, respectively. For ``hugepage_size`` type, you can specify the minimum +and maximum size of the range (closed interval) to ``min`` and ``max`` files, +respectively. For ``target`` type, you can specify the index of the target +between the list of the DAMON context's monitoring targets list to +``target_idx`` file. You can write ``Y`` or ``N`` to ``matching`` file to specify whether the filter is for memory that matches the ``type``. You can write ``Y`` or ``N`` to diff --git a/Documentation/mm/damon/design.rst b/Documentation/mm/damon/design.rst index a959c081bc59..7360e5ac0d06 100644 --- a/Documentation/mm/damon/design.rst +++ b/Documentation/mm/damon/design.rst @@ -600,23 +600,23 @@ counted as the scheme has tried. This difference affects the statistics. Below ``type`` of filters are currently supported. -- anonymous page +- anon - Applied to pages that containing data that not stored in files. - Handled by operations set layer. Supported by only ``paddr`` set. -- memory cgroup +- memcg - Applied to pages that belonging to a given cgroup. - Handled by operations set layer. Supported by only ``paddr`` set. -- young page +- 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. -- pages that managed in a given size range +- hugepage_size - Applied to pages that managed in a given size range. - Handled by operations set layer. Supported by only ``paddr`` set. -- address range +- addr - Applied to pages that belonging to a given address range. - Handled by the core logic. -- DAMON monitoring target +- target - Applied to pages that belonging to a given DAMON monitoring target. - Handled by the core logic. From patchwork Tue Feb 18 22:37:07 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 13980987 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 632E9C021AA for ; Tue, 18 Feb 2025 22:37:26 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 5D0502801AC; Tue, 18 Feb 2025 17:37:22 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 532B02801A7; Tue, 18 Feb 2025 17:37:22 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 35D7C2801AC; Tue, 18 Feb 2025 17:37:22 -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 14C8A2801A7 for ; Tue, 18 Feb 2025 17:37:22 -0500 (EST) Received: from smtpin21.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay05.hostedemail.com (Postfix) with ESMTP id A01004B95D for ; Tue, 18 Feb 2025 22:37:21 +0000 (UTC) X-FDA: 83134527882.21.9816C7A Received: from nyc.source.kernel.org (nyc.source.kernel.org [147.75.193.91]) by imf09.hostedemail.com (Postfix) with ESMTP id 04DBC140005 for ; Tue, 18 Feb 2025 22:37:19 +0000 (UTC) Authentication-Results: imf09.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=GFPQXAh9; spf=pass (imf09.hostedemail.com: domain of sj@kernel.org designates 147.75.193.91 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=1739918240; 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=EYPyL3EH7h1fgNW7JSKeeuYdIn9/GfxoINRjg7QARrw=; b=YIV8jRVcJvWh57q8vEx5O0aBRFozRoDGQuAgJN+KD8Cbt6KxQmX5aO2G+ZuZRWylUlMpdC t07EBkh7Sh57HShvJY5v0H00CNiR80XwJPLA+fv9lSmPXYLM3QB7zrVmbHE5B0flNFpg7F qUvbt5Yp+Y73K/KJ+512hn7fxNA2OyE= ARC-Authentication-Results: i=1; imf09.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=GFPQXAh9; spf=pass (imf09.hostedemail.com: domain of sj@kernel.org designates 147.75.193.91 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=1739918240; a=rsa-sha256; cv=none; b=ZrsdApDj+oxUplVvo0QENis9vwAkSslXR1X/wBUQ6SdCEr4xBDH1YVH9H1kf3rs0fDyd0V kRfsG5tPITMmw0wfOP2LuPFGdli9Z52zliY9u9mSOQFkK1cONd9PYIzgeoSvB1XoTung8h y2qyT3My997huo37GROfrmOuYXinEj4= Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by nyc.source.kernel.org (Postfix) with ESMTP id 8E9DAA41DD0; Tue, 18 Feb 2025 22:35:34 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 14831C4CEEB; Tue, 18 Feb 2025 22:37:19 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1739918239; bh=cs8GWYYnDK1JIzMR8vzHgXGMzwJ95MlnMu1w0ifV6mQ=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=GFPQXAh9VN+N/yc8FjF9P74m7RQSFVU5vj7N84H2Hx5TnOc5Q14GoVjY0jtuSRlVS EXbY1/CzBriQvD/ml+QMe7tsrwejA4KolgzANUptgJNMuunGt9kyB7WfAcz+uYJroW Qc+HeqmIZpJtzk/tpZpt9wJkK25AVCWMKOVl1Z+YBL1qTr9dNhB2lZ82cOh6l3uqMk rDqRZJX4JUYA7x2Rnuj0MiMJzGQW6+sK7fEPZjnBJYWKLuIINxYFCuiKWzP9iKc7d5 KZf6X4g1kpvOllzbjLMW0S/oIffkc9Yjg33uXj3NS093kPNgMnHq8OGKLf8Og7OLLY X1pUSNhMRtpzg== 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 4/5] Docs/mm/damon/design: clarify handling layer based filters evaluation sequence Date: Tue, 18 Feb 2025 14:37:07 -0800 Message-Id: <20250218223708.53437-5-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-Rspamd-Server: rspam04 X-Rspamd-Queue-Id: 04DBC140005 X-Stat-Signature: gwgamgs8dwgbgekrpazf6bwg3nojd6k8 X-Rspam-User: X-HE-Tag: 1739918239-510982 X-HE-Meta: U2FsdGVkX1/q4dZXaUtN0AYMApNA5roM/NKDkHR+LYHsW76neHKsi7Uu1GUVGrqongvhlKDVpdrbv6npFiCaui3X+WVOYEniWogwseQ3TTk945kbFvrSR5vgIVCFNJNsX6ys8VIAaQZobU8fbEaGjdw19dOoAGY/CgyXt4pLLUiR7EClapSPQOxrVJPigZkjm8Lr+54KvrwKmXwl12D6Atv4p98thfccKF21IhSXRCN77ay5pXFkQdiLOiHwHaUO4LMVaJKjNdxkqDiQRWG3nwNGZhpV3RIplSh60c3P2oYeLN6BEyfVEYdMN9+2dbk/S8YQtVwg9WXVBjEUc8+Q6AU9KtqESRPbtuPatboBcGF/Wos/Lek9MZWEYw9M24goyL59LuIZPN9qeKrZUBejZ4qNzrj9RQj2UNTxoMKN7uXrl7qwbud+goHLrbHQSRaDp09ErGRa2e/ueToLByOwmsTGW4R+rT9a/VonYbqU6JbLoVwrWUXLphi3oeU9CtYQpj2UTkO4bjrOB+6A/M6jEF6iGAbvMyk7CCTULOP3m1XL/5v9U9qGGlcwT3zfno6LkIcRYSRPG9j2HZ7w4Mp8i756QEKOTYo1QwvXOCSgLxaL+Kqm9wbc+mKQJXeSDxmOCYrkvn6TdwYhuUuSJ9/VA3HtKFiJVn3O5gE88v3LPPB2i1JfpEOOS9SxQeEJvS6FrQ6P8PiDfvwajCbNI2sxH7zhtOOFhFrkH/Mh28+pA5NXGszkrqtrYQJdUZmVxrtfl020d6qZZN5k7t0UzHX2JjsCm/J8+NhWE5CYRkEjQWs1EZTP82ZRC5sR8s4E6Re5TvCHpFhJGOplwU03m4xk9IgoI2JVWgbof797OXIzQOC06QGEIU1SU14975bbphdFbQhKwu20Y94f+cli98bd14Jjf9/N9J8js9uCyfkIo9Wl6D4GSJweg0lpX4t6Bp57PJBWBbnozVOGNUOpEK6 AnGgZPuk jHvpznhjvMq1i6uLefpkPwm9XHIgi5hE9/ugrH8qNkG618HT4unq0JIFeNxO8dad51h3HwtZc3x1xjwYKafKPiAw6plsSRM8AjP9wux0ncxeTf0xJCDIhj63puzda2lGVi7aWU0f3MFE2iaz3/JrhL2/kfBloa4yRKVCYq6rqJ50lwZ2os8eMxOPCCVy80VouZlWvnBhWa30/V2FTrSRR2eQHOGfALr4USSnzPdyxA6txbRM= 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: If an element of memory matches a DAMOS filter, filters that installed after that get no chance to make any effect to the element. Hence in what order DAMOS filters are handled is important, if both allow filters and reject filters are used together. The ordering is affected by both the installation order and which layter the filters are handled. The design document is not clearly documenting the latter part. Clarify it on the design doc. Signed-off-by: SeongJae Park --- Documentation/mm/damon/design.rst | 28 +++++++++++++++------------- 1 file changed, 15 insertions(+), 13 deletions(-) diff --git a/Documentation/mm/damon/design.rst b/Documentation/mm/damon/design.rst index 7360e5ac0d06..8b9727d91434 100644 --- a/Documentation/mm/damon/design.rst +++ b/Documentation/mm/damon/design.rst @@ -569,11 +569,21 @@ number of filters for each scheme. Each filter specifies - whether it is to allow (include) or reject (exclude) applying the scheme's action to the memory (``allow``). -When multiple filters are installed, each filter is evaluated in the installed -order. If a part of memory is matched to one of the filter, next filters are -ignored. If the memory passes through the filters evaluation stage because it -is not matched to any of the filters, applying the scheme's action to it is -allowed, same to the behavior when no filter exists. +For efficient handling of filters, some types of filters are handled by the +core layer, while others are handled by operations set. In the latter case, +hence, support of the filter types depends on the DAMON operations set. In +case of the core layer-handled filters, the memory regions that excluded by the +filter are not counted as the scheme has tried to the region. In contrast, if +a memory regions is filtered by an operations set layer-handled filter, it is +counted as the scheme has tried. This difference affects the statistics. + +When multiple filters are installed, the group of filters that handled by the +core layer are evaluated first. After that, the group of filters that handled +by the operations layer are evaluated. Filters in each of the groups are +evaluated in the installed order. If a part of memory is matched to one of the +filter, next filters are ignored. If the memory passes through the filters +evaluation stage because it is not matched to any of the filters, applying the +scheme's action to it is allowed, same to the behavior when no filter exists. For example, let's assume 1) a filter for allowing anonymous pages and 2) another filter for rejecting young pages are installed in the order. If a page @@ -590,14 +600,6 @@ filter-allowed or filters evaluation stage passed. It means that installing allow-filters at the end of the list makes no practical change but only filters-checking overhead. -For efficient handling of filters, some types of filters are handled by the -core layer, while others are handled by operations set. In the latter case, -hence, support of the filter types depends on the DAMON operations set. In -case of the core layer-handled filters, the memory regions that excluded by the -filter are not counted as the scheme has tried to the region. In contrast, if -a memory regions is filtered by an operations set layer-handled filter, it is -counted as the scheme has tried. This difference affects the statistics. - Below ``type`` of filters are currently supported. - anon 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