From nobody Mon Sep 15 19:19:06 2025 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 vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 78BA9C54EBC for ; Tue, 10 Jan 2023 19:04:39 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S239677AbjAJTEN (ORCPT ); Tue, 10 Jan 2023 14:04:13 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:47068 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S239485AbjAJTEI (ORCPT ); Tue, 10 Jan 2023 14:04:08 -0500 Received: from ams.source.kernel.org (ams.source.kernel.org [145.40.68.75]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id A90196418 for ; Tue, 10 Jan 2023 11:04:07 -0800 (PST) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ams.source.kernel.org (Postfix) with ESMTPS id 5335CB8196F for ; Tue, 10 Jan 2023 19:04:06 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id AB108C433D2; Tue, 10 Jan 2023 19:04:04 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1673377445; bh=EpuEVUL614S47vXoslv07ySnDH61IdNVsBrU1EkLty8=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=fCl8S7YiAsYSjVYQ6JjpL33E5Zdyh0Drih0OrdQyMBev/agRdKUdaHNWOrGbsRJsk CUm9xv0Q1qyvDy/JbGUNQAH4T2SCwyC0lwrr3By+XE5/gPxPZUEJTGvN8p9MNiYoUH fJNRL+cOlBex8DtmAvlIcioI4YLkXREUsKisYvBQRXNjsHzh6JIaPkyi0DG+RCkTkY BEggkVrMC5MbN75tGE5AjEaBQqvdq+bYZEszEMZhwLR2sFFK/im+NdyEMMbLFCwESC lsHWX7EzszK4qUGrr0DNzX1R9gXbytMa+c88X9+QFYpxaCrUt9mwFUlVLDKC/1LoiL p5PeAAxRCMc9g== From: SeongJae Park To: Andrew Morton Cc: SeongJae Park , damon@lists.linux.dev, linux-mm@kvack.org, linux-kernel@vger.kernel.org Subject: [PATCH 1/8] mm/damon/core: update kernel-doc comments for DAMOS action supports of each DAMON operations set Date: Tue, 10 Jan 2023 19:03:53 +0000 Message-Id: <20230110190400.119388-2-sj@kernel.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20230110190400.119388-1-sj@kernel.org> References: <20230110190400.119388-1-sj@kernel.org> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" Supports of each DAMOS action are up to DAMON operations set implementation in use, but not well mentioned on the kernel-doc comments. Add the comment. Signed-off-by: SeongJae Park --- include/linux/damon.h | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/include/linux/damon.h b/include/linux/damon.h index 7907918ad2e0..3fa96d7c9fe4 100644 --- a/include/linux/damon.h +++ b/include/linux/damon.h @@ -91,6 +91,12 @@ struct damon_target { * @DAMOS_LRU_DEPRIO: Deprioritize the region on its LRU lists. * @DAMOS_STAT: Do nothing but count the stat. * @NR_DAMOS_ACTIONS: Total number of DAMOS actions + * + * The support of each action is up to running &struct damon_operations. + * &enum DAMON_OPS_VADDR and &enum DAMON_OPS_FVADDR supports all actions e= xcept + * &enum DAMOS_LRU_PRIO and &enum DAMOS_LRU_DEPRIO. &enum DAMON_OPS_PADDR + * supports only &enum DAMOS_PAGEOUT, &enum DAMOS_LRU_PRIO, &enum + * DAMOS_LRU_DEPRIO, and &DAMOS_STAT. */ enum damos_action { DAMOS_WILLNEED, --=20 2.25.1 From nobody Mon Sep 15 19:19:06 2025 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 vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 21EB9C677F1 for ; Tue, 10 Jan 2023 19:05:12 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S239707AbjAJTEv (ORCPT ); Tue, 10 Jan 2023 14:04:51 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:47088 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S239665AbjAJTEJ (ORCPT ); Tue, 10 Jan 2023 14:04:09 -0500 Received: from ams.source.kernel.org (ams.source.kernel.org [IPv6:2604:1380:4601:e00::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 5BF4348CF3 for ; Tue, 10 Jan 2023 11:04:08 -0800 (PST) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ams.source.kernel.org (Postfix) with ESMTPS id F16C6B81900 for ; Tue, 10 Jan 2023 19:04:06 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 44D7DC43396; Tue, 10 Jan 2023 19:04:05 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1673377445; bh=MkYe8RMWo9Dd/HnFB4VyNk02k3Wj59bPhrWvDe74iBs=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=O12DgK0wfvcNXMnpgdQ3CN5XcfJVRvnLXxTk9Tenc6J86A71PWN8smbh8QHn6allC cieg4aoxQAsihNa53VhtzdmoGyYNK7ii4b++GyYCC8+SEUK2nVroFTJtRhlifuN9B6 k3JKMOBKw01yt0WYX/k+NOVE96xHBDfQsvj+6enjh62D0MYD9tB1eUwbw8Iq0OAuld u/mImvwo0LKCKcEhdw4QdXUDR15Y6quvIqFKYFORAhOi1B3bSKg+EKLiG5QmPXIctj hwVD9ousWKgOREOvinbJ2UEgyklCRp9pAvqzYSGgiKGqkN7oKOpIprY5BWPWc2nXls /XCndbXdU9Cqg== From: SeongJae Park To: Andrew Morton Cc: SeongJae Park , damon@lists.linux.dev, linux-mm@kvack.org, linux-kernel@vger.kernel.org Subject: [PATCH 2/8] mm/damon/core: update kernel-doc comments for DAMOS filters supports of each DAMON operations set Date: Tue, 10 Jan 2023 19:03:54 +0000 Message-Id: <20230110190400.119388-3-sj@kernel.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20230110190400.119388-1-sj@kernel.org> References: <20230110190400.119388-1-sj@kernel.org> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" Supports of each DAMOS filter type are up to DAMON operations set implementation in use, but not well mentioned on the kernel-doc comments. Add the comment. Signed-off-by: SeongJae Park --- include/linux/damon.h | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/include/linux/damon.h b/include/linux/damon.h index 3fa96d7c9fe4..dfb245bb3053 100644 --- a/include/linux/damon.h +++ b/include/linux/damon.h @@ -227,6 +227,11 @@ struct damos_stat { * @DAMOS_FILTER_TYPE_ANON: Anonymous pages. * @DAMOS_FILTER_TYPE_MEMCG: Specific memcg's pages. * @NR_DAMOS_FILTER_TYPES: Number of filter types. + * + * The support of each filter type is up to running &struct damon_operatio= ns. + * &enum DAMON_OPS_PADDR is supporting all filter types, while + * &enum DAMON_OPS_VADDR and &enum DAMON_OPS_FVADDR are not supporting any + * filter types. */ enum damos_filter_type { DAMOS_FILTER_TYPE_ANON, --=20 2.25.1 From nobody Mon Sep 15 19:19:06 2025 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 vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 8E128C678D7 for ; Tue, 10 Jan 2023 19:05:12 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S239786AbjAJTFB (ORCPT ); Tue, 10 Jan 2023 14:05:01 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:47088 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S239479AbjAJTEK (ORCPT ); Tue, 10 Jan 2023 14:04:10 -0500 Received: from ams.source.kernel.org (ams.source.kernel.org [IPv6:2604:1380:4601:e00::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 0537F640C; Tue, 10 Jan 2023 11:04:09 -0800 (PST) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ams.source.kernel.org (Postfix) with ESMTPS id B3337B81977; Tue, 10 Jan 2023 19:04:07 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id D3871C43398; Tue, 10 Jan 2023 19:04:05 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1673377446; bh=3/9jPsJGQOYl5LrCGMIIfDURssYf3Mb7HlJVYLs/nag=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=Gr+KJKuOm+aZo2aKeZ1tF+IL9mDXelWveS7Wxk+bEcvzreVPihAtB2EuuMgEG4Op+ bKsUP+zpKY5H5OKwlQ1yc0rztEYYZ8x1s0mC6r3gGnt5v4EHwJ3ZdU+seblcwUS9kJ JJRcXQkUBKSyGrsgIdCruJ94Gwan6MSt8zzoeUt8vJ7g0Q99TpzhfCz8DIwDVlC9eE gJ20GaqpN48kAhaG7aSW2eLbXd5U+5RPPD8klZYlhXRiw8ckt8WskQbS1YOuRi48x5 oRbPJPB+t0mhZ/CMMxTEZVxHRugcJwXgT99Ih/Y3waWx7CCb1xMDDlrpLe5Egv3gyc nOaZIpD2tfnvw== 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 3/8] Docs/mm/damon/index: mention DAMOS on the intro Date: Tue, 10 Jan 2023 19:03:55 +0000 Message-Id: <20230110190400.119388-4-sj@kernel.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20230110190400.119388-1-sj@kernel.org> References: <20230110190400.119388-1-sj@kernel.org> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" What DAMON aims to do is not only access monitoring but efficient and effective access-aware system operations. And DAMon-based Operation Schemes (DAMOS) is the important feature of DAMON for the goal. Make the intro of DAMON documentation to emphasize the goal and mention DAMOS. Signed-off-by: SeongJae Park --- Documentation/mm/damon/index.rst | 21 +++++++++++++-------- 1 file changed, 13 insertions(+), 8 deletions(-) diff --git a/Documentation/mm/damon/index.rst b/Documentation/mm/damon/inde= x.rst index 48c0bbff98b2..2983699c12ea 100644 --- a/Documentation/mm/damon/index.rst +++ b/Documentation/mm/damon/index.rst @@ -4,8 +4,9 @@ DAMON: Data Access MONitor =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D =20 -DAMON is a data access monitoring framework subsystem for the Linux kernel. -The core mechanisms of DAMON (refer to :doc:`design` for the detail) make = it +DAMON is a Linux kernel subsystem that provides a framework for data access +monitoring and the monitoring results based system operations. The core +monitoring mechanisms of DAMON (refer to :doc:`design` for the detail) mak= e it =20 - *accurate* (the monitoring output is useful enough for DRAM level memory management; It might not appropriate for CPU Cache levels, though), @@ -14,12 +15,16 @@ The core mechanisms of DAMON (refer to :doc:`design` fo= r the detail) make it - *scalable* (the upper-bound of the overhead is in constant range regard= less of the size of target workloads). =20 -Using this framework, therefore, the kernel's memory management mechanisms= can -make advanced decisions. Experimental memory management optimization works -that incurring high data accesses monitoring overhead could implemented ag= ain. -In user space, meanwhile, users who have some special workloads can write -personalized applications for better understanding and optimizations of th= eir -workloads and systems. +Using this framework, therefore, the kernel can operate system in an +access-aware fashion. Because the features are also exposed to the user s= pace, +users who have special information about their workloads can write persona= lized +applications for better understanding and optimizations of their workloads= and +systems. + +For easier development of such systems, DAMON provides a feature called DA= MOS +(DAMon-based Operation Schemes) in addition to the monitoring. Using the +feature, DAMON users in both kernel and user spaces can do access-aware sy= stem +operations with no code but simple configurations. =20 .. toctree:: :maxdepth: 2 --=20 2.25.1 From nobody Mon Sep 15 19:19:06 2025 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 vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 73696C61DB3 for ; Tue, 10 Jan 2023 19:05:12 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S239770AbjAJTE6 (ORCPT ); Tue, 10 Jan 2023 14:04:58 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:47100 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S239227AbjAJTEJ (ORCPT ); Tue, 10 Jan 2023 14:04:09 -0500 Received: from ams.source.kernel.org (ams.source.kernel.org [IPv6:2604:1380:4601:e00::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id C02ACC4D; Tue, 10 Jan 2023 11:04:08 -0800 (PST) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ams.source.kernel.org (Postfix) with ESMTPS id 7ED63B8190F; Tue, 10 Jan 2023 19:04:07 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 9BFFFC433F0; Tue, 10 Jan 2023 19:04:06 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1673377447; bh=z4OiBFIdAY53y3j04vvpLGBRlRRZlDz1MLs91H9dWgM=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=RLd4J3G76wYwVxSsaSIQPTKHrZbFVa3HMM1Gckqux+XKZcOj5l6ii9Jr0d5ojGaYb OaFXjgnAYAadqc1LQMKbr/wchU1RcH/S5srEO9WUXaQJQPM+kREfCpLLSMiLMLYf3H gDzFMCliEdHfnyVRMgNQz+xK5d0pqnAsKfUIEaT+Oexsy/K2x/qwH49JiW/wPCMoxr 9g8XpPSA1eSKwJO0CRhxv0rQ6oyzoFAibgVTGMFfGM+PwtytiJ2AY9IwPuYNlmbuFX 2fNEHHLpNzidac6lxcf3Yjhk5+923fksLblXxOfMoVoZtpzL1pk4Nnk8j+L3HhS2GP J9X688D+f9i7Q== 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 4/8] Docs/admin-guide/mm/damon/usage: update DAMOS actions/filters supports of each DAMON operations set Date: Tue, 10 Jan 2023 19:03:56 +0000 Message-Id: <20230110190400.119388-5-sj@kernel.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20230110190400.119388-1-sj@kernel.org> References: <20230110190400.119388-1-sj@kernel.org> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" Supports of each DAMOS action and filters are up to DAMON operations set implementation, but it's not mentioned in detail on the documentation. Update the information on the usage document. Signed-off-by: SeongJae Park --- Documentation/admin-guide/mm/damon/usage.rst | 41 +++++++++++++------- 1 file changed, 28 insertions(+), 13 deletions(-) diff --git a/Documentation/admin-guide/mm/damon/usage.rst b/Documentation/a= dmin-guide/mm/damon/usage.rst index 3d82ca6a17ff..9237d6a25897 100644 --- a/Documentation/admin-guide/mm/damon/usage.rst +++ b/Documentation/admin-guide/mm/damon/usage.rst @@ -279,14 +279,25 @@ The ``action`` file is for setting and getting what a= ction you want to apply to memory regions having specific access pattern of the interest. The keywor= ds that can be written to and read from the file and their meaning are as bel= ow. =20 - - ``willneed``: Call ``madvise()`` for the region with ``MADV_WILLNEED`` - - ``cold``: Call ``madvise()`` for the region with ``MADV_COLD`` - - ``pageout``: Call ``madvise()`` for the region with ``MADV_PAGEOUT`` - - ``hugepage``: Call ``madvise()`` for the region with ``MADV_HUGEPAGE`` - - ``nohugepage``: Call ``madvise()`` for the region with ``MADV_NOHUGEPAG= E`` +Note that support of each action depends on the running DAMON operations s= et +`implementation `. + + - ``willneed``: Call ``madvise()`` for the region with ``MADV_WILLNEED``. + Supported by ``vaddr`` and ``fvaddr`` operations set. + - ``cold``: Call ``madvise()`` for the region with ``MADV_COLD``. + Supported by ``vaddr`` and ``fvaddr`` operations set. + - ``pageout``: Call ``madvise()`` for the region with ``MADV_PAGEOUT``. + Supported by ``vaddr``, ``fvaddr`` and ``paddr`` operations set. + - ``hugepage``: Call ``madvise()`` for the region with ``MADV_HUGEPAGE``. + Supported by ``vaddr`` and ``fvaddr`` operations set. + - ``nohugepage``: Call ``madvise()`` for the region with ``MADV_NOHUGEPAG= E``. + Supported by ``vaddr`` and ``fvaddr`` operations set. - ``lru_prio``: Prioritize the region on its LRU lists. + Supported by ``paddr`` operations set. - ``lru_deprio``: Deprioritize the region on its LRU lists. - - ``stat``: Do nothing but count the statistics + Supported by ``paddr`` operations set. + - ``stat``: Do nothing but count the statistics. + Supported by all operations sets. =20 schemes//access_pattern/ --------------------------- @@ -388,8 +399,8 @@ pages of all memory cgroups except ``/having_care_alrea= dy``.:: echo /having_care_already > 1/memcg_path echo N > 1/matching =20 -Note that filters could be ignored depend on the running DAMON operations = set -`implementation `. +Note that filters are currently supported only when ``paddr`` +`implementation ` is being used. =20 .. _sysfs_schemes_stats: =20 @@ -618,11 +629,15 @@ The ```` is a predefined integer for memory m= anagement actions, which DAMON will apply to the regions having the target access pattern. The supported numbers and their meanings are as below. =20 - - 0: Call ``madvise()`` for the region with ``MADV_WILLNEED`` - - 1: Call ``madvise()`` for the region with ``MADV_COLD`` - - 2: Call ``madvise()`` for the region with ``MADV_PAGEOUT`` - - 3: Call ``madvise()`` for the region with ``MADV_HUGEPAGE`` - - 4: Call ``madvise()`` for the region with ``MADV_NOHUGEPAGE`` + - 0: Call ``madvise()`` for the region with ``MADV_WILLNEED``. Ignored if + ``target`` is ``paddr``. + - 1: Call ``madvise()`` for the region with ``MADV_COLD``. Ignored if + ``target`` is ``paddr``. + - 2: Call ``madvise()`` for the region with ``MADV_PAGEOUT``. + - 3: Call ``madvise()`` for the region with ``MADV_HUGEPAGE``. Ignored if + ``target`` is ``paddr``. + - 4: Call ``madvise()`` for the region with ``MADV_NOHUGEPAGE``. Ignored= if + ``target`` is ``paddr``. - 5: Do nothing but count the statistics =20 Quota --=20 2.25.1 From nobody Mon Sep 15 19:19:06 2025 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 vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id A34C8C678D6 for ; Tue, 10 Jan 2023 19:05:12 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S239807AbjAJTFF (ORCPT ); Tue, 10 Jan 2023 14:05:05 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:47126 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S239663AbjAJTEL (ORCPT ); Tue, 10 Jan 2023 14:04:11 -0500 Received: from ams.source.kernel.org (ams.source.kernel.org [IPv6:2604:1380:4601:e00::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 8EDCD48CF3; Tue, 10 Jan 2023 11:04:10 -0800 (PST) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ams.source.kernel.org (Postfix) with ESMTPS id 44716B81978; Tue, 10 Jan 2023 19:04:09 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 65048C433EF; Tue, 10 Jan 2023 19:04:07 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1673377447; bh=/ftDYRYihjGl5PEz5Dv1FCnL2ESZwAkvBGHkxClfATA=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=dWdbcT4V6ti0Ll/sRjROvWkvtNQCTLv7+0IA+XG0QqOdhMMLgUnm9HgZ6MnDDqEOl dngadbkAJrq2Vcj6erIyqDlcg0E31UlwF/+Id7rxgO3NvcGdeYMCONmYVP+oAiH7x4 TO1md/05eBEiK10d48YhUKg5Gx6E2K0Y9B6FaQ2yhy4EBLYZVq1+ecmxQqpzpN3X/B AH9Ox0o/TVtIAvmzC8VLqBZ6zpmGCH3dWfk+S1l4i//UegMvXlBHbyTu5F5LbItnIS XrTV3fqkCIvSfQUTlspFp8isWnSa3kugYmoPy5NFx4NNsWlxZaI+EA28ngOGYVYwZ/ v7ZC9g9RiHveA== 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/8] Docs/mm/damon: add a maintainer-profile for DAMON Date: Tue, 10 Jan 2023 19:03:57 +0000 Message-Id: <20230110190400.119388-6-sj@kernel.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20230110190400.119388-1-sj@kernel.org> References: <20230110190400.119388-1-sj@kernel.org> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" Document the basic policies and expectations for DAMON development. Signed-off-by: SeongJae Park --- Documentation/mm/damon/index.rst | 1 + Documentation/mm/damon/maintainer-profile.rst | 62 +++++++++++++++++++ 2 files changed, 63 insertions(+) create mode 100644 Documentation/mm/damon/maintainer-profile.rst diff --git a/Documentation/mm/damon/index.rst b/Documentation/mm/damon/inde= x.rst index 2983699c12ea..5e0a50583500 100644 --- a/Documentation/mm/damon/index.rst +++ b/Documentation/mm/damon/index.rst @@ -32,3 +32,4 @@ operations with no code but simple configurations. faq design api + maintainer-profile diff --git a/Documentation/mm/damon/maintainer-profile.rst b/Documentation/= mm/damon/maintainer-profile.rst new file mode 100644 index 000000000000..24a202f03de8 --- /dev/null +++ b/Documentation/mm/damon/maintainer-profile.rst @@ -0,0 +1,62 @@ +.. SPDX-License-Identifier: GPL-2.0 + +DAMON Maintainer Entry Profile +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D + +The DAMON subsystem covers the files that listed in 'DATA ACCESS MONITOR' +section of 'MAINTAINERS' file. + +The mailing lists for the subsystem are damon@lists.linux.dev and +linux-mm@kvack.org. Patches should be made against the mm-unstable tree [= 1]_ +whenever possible and posted to the mailing lists. + +SCM Trees +--------- + +There are multiple Linux trees for DAMON development. Patches under +development or testing are queued in damon/next [2]_ by the DAMON maintain= er. +Suffieicntly reviewed patches will be queued in mm-unstable [1]_ by the me= mory +management subsystem maintainer. After more sufficient tests, the patches= will +be queued in mm-stable [3]_ , and finally pull-requested to the mainline b= y the +memory management subsystem maintainer. + +Note again the patches for review should be made against the mm-unstable +tree[1] whenever possible. damon/next is only for preview of others' work= s in +progress. + +Submit checklist addendum +------------------------- + +When making DAMON changes, you should do below. + +- Build changes related outputs including kernel and documents. +- Ensure the builds introduce no new errors or warnings. +- Run and ensure no new failures for DAMON selftests [4]_ and kunittests [= 5]_ . + +Further doing below and putting the results will be helpful. + +- Run damon-tests/corr [6]_ for normal changes. +- Run damon-tests/perf [7]_ for performance changes. + +Key cycle dates +--------------- + +Patches can be sent anytime. Key cycle dates of the mm-unstable[1] and +mm-stable[3] trees depend on the memory management subsystem maintainer. + +Review cadence +-------------- + +The DAMON maintainer does the work on the usual work hour (09:00 to 17:00, +Mon-Fri) in PST. The response to patches will occasionally be slow. Do n= ot +hesitate to send a ping if you have not heard back within a week of sendin= g a +patch. + + +.. [1] https://git.kernel.org/akpm/mm/h/mm-unstable +.. [2] https://git.kernel.org/sj/h/damon/next +.. [3] https://git.kernel.org/akpm/mm/h/mm-stable +.. [4] https://github.com/awslabs/damon-tests/blob/master/corr/run.sh#L49 +.. [5] https://github.com/awslabs/damon-tests/blob/master/corr/tests/kunit= .sh +.. [6] https://github.com/awslabs/damon-tests/tree/master/corr +.. [7] https://github.com/awslabs/damon-tests/tree/master/perf --=20 2.25.1 From nobody Mon Sep 15 19:19:06 2025 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 vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id A31BFC54EBE for ; Tue, 10 Jan 2023 19:05:14 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S239838AbjAJTFL (ORCPT ); Tue, 10 Jan 2023 14:05:11 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:47128 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S239669AbjAJTEL (ORCPT ); Tue, 10 Jan 2023 14:04:11 -0500 Received: from ams.source.kernel.org (ams.source.kernel.org [145.40.68.75]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 150F3C2C for ; Tue, 10 Jan 2023 11:04:11 -0800 (PST) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ams.source.kernel.org (Postfix) with ESMTPS id C47E3B8197A for ; Tue, 10 Jan 2023 19:04:09 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 235EAC433D2; Tue, 10 Jan 2023 19:04:08 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1673377448; bh=yhlx99wApZuf1+oxV+tS5tr85ZKJgTLb2t8Dhjj3q6I=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=fw8T8JX5qowhaM7imY0QxW2TLNYGjTeDjVNkpnJQmEbxf5CNLt8o+rYHK3k4Db4Ct JdhmGxrvKh46Iz1btrYZ2FRwg6N3qPm9NMLs8Ocpt7517+bN7F4lVHnKks+XUAqqsk f/2Tas3X/hU7xq+zQwB5Hj76Z6YB4voWxzE+Ql6Hbcytnpo4Qt6IWBimgn+D0cxp/4 ijA/gPb95yECvGpimIHZChLCYtAfHO59f1Hyh+cvixYJyYwUWlM/W4e2JX54hUXYL6 cWm5irf5P0+fa+F7BOltbdvyueoCHNnKyEtHSkMGWBFwM+4mMSf/F/L9Ln4J/tzmoP EYy2wqxHACKIA== From: SeongJae Park To: Andrew Morton Cc: SeongJae Park , damon@lists.linux.dev, linux-mm@kvack.org, linux-kernel@vger.kernel.org Subject: [PATCH 6/8] MAINTAINERS/DAMON: link maintainer profile, git trees, and website Date: Tue, 10 Jan 2023 19:03:58 +0000 Message-Id: <20230110190400.119388-7-sj@kernel.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20230110190400.119388-1-sj@kernel.org> References: <20230110190400.119388-1-sj@kernel.org> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" Add links to below DAMON development related resource to DAMON section in MAINTAINERS file. - The basic policies and expectations of DAMON development, - DAMON development trees, and - DAMON introduction website. Signed-off-by: SeongJae Park --- MAINTAINERS | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/MAINTAINERS b/MAINTAINERS index 9a0c3d3b9093..4b222f67663a 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -5790,6 +5790,11 @@ M: SeongJae Park L: damon@lists.linux.dev L: linux-mm@kvack.org S: Maintained +W: https://damonitor.github.io +P: Documentation/mm/damon/maintainer-profile.rst +T: git git://git.kernel.org/pub/scm/linux/kernel/git/akpm/mm +T: quilt git://git.kernel.org/pub/scm/linux/kernel/git/akpm/25-new +T: git git://git.kernel.org/pub/scm/linux/kernel/git/sj/linux.git damon/ne= xt F: Documentation/ABI/testing/sysfs-kernel-mm-damon F: Documentation/admin-guide/mm/damon/ F: Documentation/mm/damon/ --=20 2.25.1 From nobody Mon Sep 15 19:19:06 2025 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 vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 4CA33C678D5 for ; Tue, 10 Jan 2023 19:05:12 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S239739AbjAJTEz (ORCPT ); Tue, 10 Jan 2023 14:04:55 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:47114 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S239667AbjAJTEK (ORCPT ); Tue, 10 Jan 2023 14:04:10 -0500 Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 486C913E90; Tue, 10 Jan 2023 11:04:10 -0800 (PST) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by dfw.source.kernel.org (Postfix) with ESMTPS id C3A93618A8; Tue, 10 Jan 2023 19:04:09 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id B1CDBC43396; Tue, 10 Jan 2023 19:04:08 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1673377449; bh=y7EJfcMY/StD0BzUoTQruwXSI1p0oqW6ITb/hdOvcrQ=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=CLZxihBAiJLZVfs0Gql2wf2QPPpAjOoIvVTvC1iFyj15MBftu/CkfH34Vda0M8H6A LVdNE4VpqvAcjUx/zCJtqza160cp3d50h7xIVoxs60At+V3fa0aN6iunDJ7NIIJT0Y uLELoRXyzQpaM/X4QQJzBSrER3vmzj0DSOzyhP+cmAqIO2ldcW1K5BrRXmvprqlOio kWJAaRkw33Y7Qb2FfE3pAkEjdB919Knkdv2dqXm3aJMFHqS3pmTEWyFN8SzIhwt0tx J9xaMoKq9Ad7/6vJKGdeOLKcMhTsN2yzZvnJLAmfSx3F+TGIGrmbMuIwiZejTfiXQw gS7Fy5LrDtfzw== From: SeongJae Park To: Andrew Morton Cc: SeongJae Park , Shuah Khan , damon@lists.linux.dev, linux-mm@kvack.org, linux-kselftest@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH 7/8] selftests/damon/sysfs: hide expected write failures Date: Tue, 10 Jan 2023 19:03:59 +0000 Message-Id: <20230110190400.119388-8-sj@kernel.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20230110190400.119388-1-sj@kernel.org> References: <20230110190400.119388-1-sj@kernel.org> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" DAMON selftests for sysfs (sysfs.sh) tests if some writes to DAMON sysfs interface files fails as expected. It makes the test results noisy with the failure error message because it tests a number of such failures. Redirect the expected failure error messages to /dev/null to make the results clean. Signed-off-by: SeongJae Park --- tools/testing/selftests/damon/sysfs.sh | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tools/testing/selftests/damon/sysfs.sh b/tools/testing/selftes= ts/damon/sysfs.sh index a00336ffdcad..bcd4734ca094 100644 --- a/tools/testing/selftests/damon/sysfs.sh +++ b/tools/testing/selftests/damon/sysfs.sh @@ -24,7 +24,7 @@ ensure_write_fail() content=3D$2 reason=3D$3 =20 - if echo "$content" > "$file" + if (echo "$content" > "$file") 2> /dev/null then echo "writing $content to $file succeed ($fail_reason)" echo "expected failure because $reason" --=20 2.25.1 From nobody Mon Sep 15 19:19:06 2025 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 vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id ACE5CC54EBC for ; Tue, 10 Jan 2023 19:05:25 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S239735AbjAJTFY (ORCPT ); Tue, 10 Jan 2023 14:05:24 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:47150 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S239679AbjAJTEO (ORCPT ); Tue, 10 Jan 2023 14:04:14 -0500 Received: from sin.source.kernel.org (sin.source.kernel.org [IPv6:2604:1380:40e1:4800::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 68AAAC2C; Tue, 10 Jan 2023 11:04:13 -0800 (PST) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by sin.source.kernel.org (Postfix) with ESMTPS id B4C0BCE18D7; Tue, 10 Jan 2023 19:04:11 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 6BBFCC433F0; Tue, 10 Jan 2023 19:04:09 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1673377449; bh=CjhxKTgVu+lPp4HMYYUYnXVejaSmINVAMJdDe1Xu9yw=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=k9iw2rZ6IgCzqVQBdYfz7/bh7pKhBy1FK+wxTqUl4jmsut3RCJjFMQ1iXDcc3yG3g ubQRNrcDKuML+gAAHhG/o2oIDoU0TNhHHsHQytYLNAHxwWHfHNvbtBi9ytfESI4MnH jphspOWxy3DGuZw7GJ9uRW1Vge4F5VWvuzH2dw3zS4uPT/Qm6JaveOZol+/Qmximra z0bItMD2PlFtwfc92SGvmZTfoLuPUjMbiUV5pdVgi64g2QU+GBFxkDLhZH8tCZZn/u 55l2ZlUFIEAZtEMyfMhDiv4kJAus9+cQjzHXnbUXQoiiYsN4VQZjLPdrXhoaGy9nkw puw4xPVZ3JB6Q== From: SeongJae Park To: Andrew Morton Cc: SeongJae Park , Shuah Khan , damon@lists.linux.dev, linux-mm@kvack.org, linux-kselftest@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH 8/8] selftests/damon/debugfs_rm_non_contexts: hide expected write error messages Date: Tue, 10 Jan 2023 19:04:00 +0000 Message-Id: <20230110190400.119388-9-sj@kernel.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20230110190400.119388-1-sj@kernel.org> References: <20230110190400.119388-1-sj@kernel.org> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" A selftest case for DAMON debugfs interface has a test for expected failure. To make the test output clean, hide the expected failure error message. Signed-off-by: SeongJae Park --- tools/testing/selftests/damon/debugfs_rm_non_contexts.sh | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tools/testing/selftests/damon/debugfs_rm_non_contexts.sh b/too= ls/testing/selftests/damon/debugfs_rm_non_contexts.sh index 48b7af6b022c..f3ffeb1343cf 100644 --- a/tools/testing/selftests/damon/debugfs_rm_non_contexts.sh +++ b/tools/testing/selftests/damon/debugfs_rm_non_contexts.sh @@ -10,7 +10,7 @@ dmesg -C =20 for file in "$DBGFS/"* do - echo "$(basename "$f")" > "$DBGFS/rm_contexts" + (echo "$(basename "$f")" > "$DBGFS/rm_contexts") &> /dev/null if dmesg | grep -q BUG then dmesg --=20 2.25.1