From nobody Sat Feb 7 18:16:05 2026 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 55F5B22B8C5; Sun, 18 Jan 2026 18:03:12 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1768759392; cv=none; b=Y5OpMnK3zS14mkMgeEBqoOi8JiaQamWU1g7plDEOyJzu5Ki/eU4OZm+JzQvDvXlVtVSb1vXL7Z5dByCHHJxbJTZgd8mGqDH/eodOz2b7oeACkXmImHX6tizH1QF9VccEvjpa889PvvTBzbl/pCx0melYhRGiwypEue/xfSF+/aQ= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1768759392; c=relaxed/simple; bh=83IuoEFZc740QLG5aKQwcz8CHpKwZZ8E6QMpPE52AHk=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=olw8KjORc1py73wRD46UzRSIXqlWyHxcd3Es3kaRgraLQqx0xWUdLDsvFOee+7mGBEySt8N/eTev2pUTFc5/EYqMplp2xlsORPdWmxZeIJPh9tG95jT8kHJmCqfvLt6vOfzfwuyM8SDeQ5HGsgGejQDln/gdndjakXXFctpOQn8= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=fWz+F1u2; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="fWz+F1u2" Received: by smtp.kernel.org (Postfix) with ESMTPSA id AAF20C19423; Sun, 18 Jan 2026 18:03:11 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1768759391; bh=83IuoEFZc740QLG5aKQwcz8CHpKwZZ8E6QMpPE52AHk=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=fWz+F1u2EZ9yGEw3rOBKhxt5QQtmFKsc3wwyz5sy4hP1KAsBNR9Sm/3l+es57SZJ8 1YXKlPu02whCdxvVeJTqyJBLKNZYHS7jDfwCQIRCWItCKrbHn6XIp+rlfStnSGEhgv kt0Jro1/f3e+3xdh05vBDp1tpLUF6/8b/AlM0rsSHrvUF/e5H708cVhSRiuwQmCPGt ttEl49dq4FxIgNVXutmlwFMbukr3l6gpV5j906Ot9HyXixjYFXhNGzEwFMrCVZ5bHt hduyjVpjCRY4qwWk7fvBWcXLYxiOXOS4wH4RWdwuBVswxPNlTfRyTxgob1rGJexsB2 JjEuCFXgguSvw== From: SeongJae Park To: Andrew Morton Cc: SeongJae Park , "Liam R. Howlett" , David Hildenbrand , Jonathan Corbet , Lorenzo Stoakes , Michal Hocko , Mike Rapoport , Suren Baghdasaryan , Vlastimil Babka , damon@lists.linux.dev, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-mm@kvack.org Subject: [PATCH 1/8] Docs/mm/damon/index: simplify the intro Date: Sun, 18 Jan 2026 10:02:52 -0800 Message-ID: <20260118180305.70023-2-sj@kernel.org> X-Mailer: git-send-email 2.47.3 In-Reply-To: <20260118180305.70023-1-sj@kernel.org> References: <20260118180305.70023-1-sj@kernel.org> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" The intro is a bit verbose and redundant. Simplify it by replacing details with more links to the design docs, and refining the design points list. Signed-off-by: SeongJae Park --- Documentation/mm/damon/index.rst | 31 +++++++++---------------------- 1 file changed, 9 insertions(+), 22 deletions(-) diff --git a/Documentation/mm/damon/index.rst b/Documentation/mm/damon/inde= x.rst index 31c1fa955b3d..82f6c5eea49a 100644 --- a/Documentation/mm/damon/index.rst +++ b/Documentation/mm/damon/index.rst @@ -4,28 +4,15 @@ DAMON: Data Access MONitoring and Access-aware System Operations =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=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=3D=3D=3D=3D =20 -DAMON is a Linux kernel subsystem that provides a framework for data access -monitoring and the monitoring results based system operations. The core -monitoring :ref:`mechanisms ` of DAMON make it - - - *accurate* (the monitoring output is useful enough for DRAM level memory - management; It might not appropriate for CPU Cache levels, though), - - *light-weight* (the monitoring overhead is low enough to be applied onl= ine), - and - - *scalable* (the upper-bound of the overhead is in constant range regard= less - of the size of target workloads). - -Using this framework, therefore, the kernel can operate system in an -access-aware fashion. Because the features are also exposed to the :doc:`= user -space `, users who have special information a= bout -their workloads can write personalized applications for better understandi= ng -and optimizations of their workloads and systems. - -For easier development of such systems, DAMON provides a feature called -:ref:`DAMOS ` (DAMon-based Operation Schemes) in addit= ion -to the monitoring. Using the feature, DAMON users in both kernel and :doc= :`user -spaces ` can do access-aware system operations -with no code but simple configurations. +DAMON is a Linux kernel subsystem for efficient :ref:`data access monitori= ng +` and :ref:`access-aware system operations +`. It is designed for being + + - *accurate* (for DRAM level memory management), + - *light-weight* (for production online usages), + - *scalable* (in terms of memory size), + - *tunable* (for flexible usages), and + - *autoamted* (for production operation without manual tunings). =20 .. toctree:: :maxdepth: 2 --=20 2.47.3 From nobody Sat Feb 7 18:16:05 2026 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 6F64123315A; Sun, 18 Jan 2026 18:03:12 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1768759392; cv=none; b=VU01aZvp7QSNXawhkjHAJRpe1A519TjfKmpXnJZJJX+ld/CnibBUcmIrXUaTOeZ1Z3iOMIslZYjuLrX2RGzNzSlF/w99vHICsIEj1yOuPFPF2o9NwUP7qqZlRYBeaQKjJ1jGGN83iLbUs7y2a7fqOKc/qqZfc5ZFLLl+PD4Haq4= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1768759392; c=relaxed/simple; bh=I6FIvpCZnqc0+Nxtus5G/drPLTTVOCDnzupWLi+vC60=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=ZD5ZK7sakfGswFpvSqQhMK9YMBzZ5QlnOC7UBlFYUmICPxTK5EhzmGBql1F9i8x5YPCi1HxzqFIDEkKL7bTZsqd4LdfGEKwiSZSa4Lqx+mEo3VjMxmU6aSHnOY8jcL+w56ErtPJ+9dU578HwkIeKFqZdvzQ9dYlrvfJ15nQAAnA= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=OP7NIgjK; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="OP7NIgjK" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 148C0C2BC9E; Sun, 18 Jan 2026 18:03:12 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1768759392; bh=I6FIvpCZnqc0+Nxtus5G/drPLTTVOCDnzupWLi+vC60=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=OP7NIgjKh+KigUkX5vwOsPfqukrM173PzOHmo+HcScObB99mbsPJy4/Q63zTPu+ul UdGSUUGj4RRgbR8c16U+gYmMnboSaKZD/4RSgRZE2IvwVy+1WJCoEklePTi+2K+gxz WGRcJPniDM3Or431A3vO7RsPETKXfKWzAHDlrx9zxLIhCavp9itljcAN7844OrRGGr dHc2FQa9BFjhioAvYIYThHgwr0DIMVbS8Lnl3NPnI5aQfWfDt7SZBbnOgJNJkC4gsw vZr/7yzJc2/weeb0LFWqRzMjGvi7hYxcnvazpZVO/uOrUsxRJ3wjDo+6/rn/z8h6yt 8sf2r77Cgk1bw== From: SeongJae Park To: Andrew Morton Cc: SeongJae Park , "Liam R. Howlett" , David Hildenbrand , Jonathan Corbet , Lorenzo Stoakes , Michal Hocko , Mike Rapoport , Suren Baghdasaryan , Vlastimil Babka , damon@lists.linux.dev, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-mm@kvack.org Subject: [PATCH 2/8] Docs/mm/damon/design: link repology instead of Fedora package Date: Sun, 18 Jan 2026 10:02:53 -0800 Message-ID: <20260118180305.70023-3-sj@kernel.org> X-Mailer: git-send-email 2.47.3 In-Reply-To: <20260118180305.70023-1-sj@kernel.org> References: <20260118180305.70023-1-sj@kernel.org> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" The document is introducing Fedora as one way to get DAMON user-space tool (damo) from OS-providing packaging system. Linux distros more than Fedora are providing damo with their packaging systems, though. Replace the Fedora part with the repology.org page that shows damo packaging status for multiple Linux distros. Signed-off-by: SeongJae Park --- Documentation/mm/damon/design.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Documentation/mm/damon/design.rst b/Documentation/mm/damon/des= ign.rst index 0cfd4c25e92d..f3db943d7efc 100644 --- a/Documentation/mm/damon/design.rst +++ b/Documentation/mm/damon/design.rst @@ -809,8 +809,8 @@ The ABIs are designed to be used for user space applica= tions development, rather than human beings' fingers. Human users are recommended to use such user space tools. One such Python-written user space tool is available at Github (https://github.com/damonitor/damo), Pypi -(https://pypistats.org/packages/damo), and Fedora -(https://packages.fedoraproject.org/pkgs/python-damo/damo/). +(https://pypistats.org/packages/damo), and multiple distros +(https://repology.org/project/damo/versions). =20 Currently, one module for this type, namely 'DAMON sysfs interface' is available. Please refer to the ABI :ref:`doc ` for detai= ls of --=20 2.47.3 From nobody Sat Feb 7 18:16:05 2026 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id CB6412FE58F; Sun, 18 Jan 2026 18:03:12 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1768759392; cv=none; b=ibUpcQ6bQo3SJqTIOjWkPLEGdWJCjPvKeo6Aq00SUv2cYiTO2Xj/G6wwklwQmJ1ob8C1qncDWKtZdWAogP46Wevsi/C85lFdWFHhDj4dOFccaEr5s4+YITFwxW1AUQ7DBpPr0kWe1oLZTWk8pp/Ov6vipREbo8HddLibxRzlenk= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1768759392; c=relaxed/simple; bh=xYh/MGaprulPNWNckX8ng3qqlquYOGwnkkCr2j/CcxI=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=oovlzLhsnb47HLpfQ3J/z8HFQ0kowz1j89jDqQKGf15utg31bkgEV/gSiUtixlhgke5n1vYZyYYY7wjOO4/OJ2WQa+F3qhbrizIaVl5TVmKvikV5cJQhlg5PaLsmnPravexhmHEJYnds2LNKoPzi0rn/wcY99Vi+aEMFa8x6+fY= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=fF4nwr89; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="fF4nwr89" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 6F710C19425; Sun, 18 Jan 2026 18:03:12 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1768759392; bh=xYh/MGaprulPNWNckX8ng3qqlquYOGwnkkCr2j/CcxI=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=fF4nwr89OKAuUIN3mG1fkkDWDB5TKShvMFkqun5REmQjGP9UF46WnzFMcFDo6PlzG UNTds1GHE2O+QypTxIbRTb8DC8D2RAb1tk/W3BnGyZuCC8JKVLYQx4sXfgYVyxYkeu SEhkr+G16cNxUTT6eW/NfCye+8yZdGTEhUuQrjvvt3eQ6UQrJ/AH243W1Ebd3HYXwH ly9seughSUdCihmUS0J+8xsTBbpf57CbSg1xl3ay3OpgIfPzWLZAWavdeAidWlngLi WK5IIZ/RaCtKOnNod0QlDFm1TFHYO47JOqvB4xfz5oAvogUQYtnwg9kU9h5i+FweWH hYMCfaIghU+YA== From: SeongJae Park To: Andrew Morton Cc: SeongJae Park , "Liam R. Howlett" , David Hildenbrand , Jonathan Corbet , Lorenzo Stoakes , Michal Hocko , Mike Rapoport , Suren Baghdasaryan , Vlastimil Babka , damon@lists.linux.dev, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-mm@kvack.org Subject: [PATCH 3/8] Docs/mm/damon/design: document DAMON sample modules Date: Sun, 18 Jan 2026 10:02:54 -0800 Message-ID: <20260118180305.70023-4-sj@kernel.org> X-Mailer: git-send-email 2.47.3 In-Reply-To: <20260118180305.70023-1-sj@kernel.org> References: <20260118180305.70023-1-sj@kernel.org> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" People sometimes get confused about the purposes of DAMON special-purpose modules and sample modules. Clarify those on the design document by adding a section describing their existence and purposes. Signed-off-by: SeongJae Park --- Documentation/mm/damon/design.rst | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/Documentation/mm/damon/design.rst b/Documentation/mm/damon/des= ign.rst index f3db943d7efc..da0bc40c2261 100644 --- a/Documentation/mm/damon/design.rst +++ b/Documentation/mm/damon/design.rst @@ -836,3 +836,16 @@ modules for proactive reclamation and LRU lists manipu= lation are provided. For more detail, please read the usage documents for those (:doc:`/admin-guide/mm/damon/reclaim` and :doc:`/admin-guide/mm/damon/lru_sort`). + + +Sample DAMON Modules +-------------------- + +DAMON modules that provides example DAMON kernel API usages. + +kernel programmers can build their own special or general purpose DAMON mo= dules +using DAMON kernel API. To help them easily understand how DAMON kernel A= PI +can be used, a few sample modules are provided under ``samples/damon/`` of= the +linux source tree. Please note that these modules are not developed for b= eing +used on real products, but only for showing how DAMON kernel API can be us= ed in +simple ways. --=20 2.47.3 From nobody Sat Feb 7 18:16:05 2026 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 58F792FFDFA; Sun, 18 Jan 2026 18:03:13 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1768759393; cv=none; b=ow3MwrA9yqXmVACO6rfM7HXUbKh8aE6zZ7u3RLRVLy+bofSujf2S1Ap3B3jEoNy1zAu3OFvIyuj+vTEBBwAuhTzlFeQ5AfUWkdmchGtxzji0ihyH+qQRvTWLWEwb9jLufFOzgo0Ek/88TUX155FQKg2Z6Lw60bypFio+502oN2c= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1768759393; c=relaxed/simple; bh=kKivkzBbiXhusYPA4CZvWuiT6LLGAcIHoC107wxKjT8=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=ijCAIYuvWacZDwx3R/EsXK35JMfQ4ayaeaAb5767ypxplUPGV5b8q+zjruKS10xhe/Lar3l8OhAVDagvgwGaUoNCoAoISWFnXunIPM3EUxB5RpB+viiGLxrlvi5Pe1XhlqlPu55mjurb3Jbq44Ugx6erNU4OwGUyCRQBfycoG9Q= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=SSD+bNz3; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="SSD+bNz3" Received: by smtp.kernel.org (Postfix) with ESMTPSA id CABEBC2BC86; Sun, 18 Jan 2026 18:03:12 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1768759393; bh=kKivkzBbiXhusYPA4CZvWuiT6LLGAcIHoC107wxKjT8=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=SSD+bNz3uMdp1Ai4DC9qcx7XGfCRHvF82aWlIkI8LkbzdKtGwhY8eZY8ddphTbF1I rH24XGtcKrBvYKQi4hEkUxShF6e3jwwIGd4eAlXqknADMhGvvjw6JY4TJc5caMaQx1 k2HnWCWrqbVWc13mN4KaHojAi0dKqUJqvCqDKYhhDRQlgOVbxpO3bSnSAUQd01+3a7 9YgtVGy8LU+0GF3APRr0AelWTAPPASpqzm40cbA49FXhyVDYg1dVNlrJct9FGbY90g /qPiMgm8xW8liWWCHJT/uLFQKj/1Dw/KRxo0B8edbcpQqSxWKV3PaJkfwtvTf+M3Hj uOgKAkgG/Hq1Q== From: SeongJae Park To: Andrew Morton Cc: SeongJae Park , "Liam R. Howlett" , David Hildenbrand , Jonathan Corbet , Lorenzo Stoakes , Michal Hocko , Mike Rapoport , Suren Baghdasaryan , Vlastimil Babka , damon@lists.linux.dev, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-mm@kvack.org Subject: [PATCH 4/8] Docs/mm/damon/design: add reference to DAMON_STAT usage Date: Sun, 18 Jan 2026 10:02:55 -0800 Message-ID: <20260118180305.70023-5-sj@kernel.org> X-Mailer: git-send-email 2.47.3 In-Reply-To: <20260118180305.70023-1-sj@kernel.org> References: <20260118180305.70023-1-sj@kernel.org> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Design document's special-purpose DAMON modules section is providing the list of links to the usage documents of existing DAMON modules. It is missing the link for DAMON_STAT, though. Add the missed link. 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/des= ign.rst index da0bc40c2261..c10a3dea3aa8 100644 --- a/Documentation/mm/damon/design.rst +++ b/Documentation/mm/damon/design.rst @@ -834,7 +834,7 @@ To support such cases, yet more DAMON API user kernel m= odules that provide more simple and optimized user space interfaces are available. Currently, two modules for proactive reclamation and LRU lists manipulation are provided.= For more detail, please read the usage documents for those -(:doc:`/admin-guide/mm/damon/reclaim` and +(:doc:`/admin-guide/mm/damon/stat`, :doc:`/admin-guide/mm/damon/reclaim` a= nd :doc:`/admin-guide/mm/damon/lru_sort`). =20 =20 --=20 2.47.3 From nobody Sat Feb 7 18:16:05 2026 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 89DC72FFFAB; Sun, 18 Jan 2026 18:03:13 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1768759393; cv=none; b=c2PIfkvXJ3Fn51Dd2QdWfId68zqEExg3TKqUDEgWEg38RVQdjRYeXUGxV2o2LnD7j6JtZ4tLOsZSOugAiLPuCJm1ebzQ8sZih9f/3FyBD2v0PobDZfMqETQT1hEQeaWLFEAhvJZiqCTGAjvPUhinVREwXAmQblqta5jo5rSa1D0= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1768759393; c=relaxed/simple; bh=CpkInp8OpjPiUKQxZORXcWjG5Pmwu5eA5tM4rzL8LFY=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=jYXAWQID5DTw178dJbporNDV1K6w2+TMmErV/hbdZwKgDcjp832UPjB/pv8AhwG3HmSCAitkxCLpk+ODT7D4EwmEdORunXd+i+mb63W4pLw9v7+6LAqI9rcdEu3uEgTI0rx8CwfouR/r2QcRZWpvYJr3BLtaKty6NtW4DZVb5DI= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=k9Lg8HKk; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="k9Lg8HKk" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 304EEC19425; Sun, 18 Jan 2026 18:03:13 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1768759393; bh=CpkInp8OpjPiUKQxZORXcWjG5Pmwu5eA5tM4rzL8LFY=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=k9Lg8HKkYM4sv5a6oLEZG9b89pl/Fd++MYtPd4kiHVDHOHfpfpdzZw0FX4WliRbZm TaLCVsdHX4ji3hbO85tBz2FhQ2JJWa+8aEIICc3n+lcPOLcEl+KxrD19C1j3vBgz1F fpPYtfEUQ2d3fGKiXJpzMtpY2CWSmx3QsRvO4LNh+7nczjOsdZigYW2P6OtDXCy+0t cJGYEztROSVCdULhwwRhUSqWMiLkhTU82CJHSZLtF0MCR7IbUMP80cXRX5taizIDZ9 3Q3d3Yv5qBxSMyL4Iip3d+NyqsLH4wQXijKdnt4L7YvrXZYTON1Bt1Td8fRgvYcjJi R9zbvlfIFMyLg== From: SeongJae Park To: Andrew Morton Cc: SeongJae Park , "Liam R. Howlett" , David Hildenbrand , Jonathan Corbet , Lorenzo Stoakes , Michal Hocko , Mike Rapoport , Suren Baghdasaryan , Vlastimil Babka , damon@lists.linux.dev, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-mm@kvack.org Subject: [PATCH 5/8] Docs/admin-guide/mm/damon/usage: introduce DAMON modules at the beginning Date: Sun, 18 Jan 2026 10:02:56 -0800 Message-ID: <20260118180305.70023-6-sj@kernel.org> X-Mailer: git-send-email 2.47.3 In-Reply-To: <20260118180305.70023-1-sj@kernel.org> References: <20260118180305.70023-1-sj@kernel.org> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" DAMON usage document provides a list of available DAMON interfaces with brief introduction at the beginning of the doc. The list is missing DAMON modules for special purposes, while it is one of the major suggested interfaces. Add an item for those to the list. Signed-off-by: SeongJae Park --- Documentation/admin-guide/mm/damon/usage.rst | 5 +++++ Documentation/mm/damon/design.rst | 2 ++ 2 files changed, 7 insertions(+) diff --git a/Documentation/admin-guide/mm/damon/usage.rst b/Documentation/a= dmin-guide/mm/damon/usage.rst index 7da4c002cb39..bfaee977c37c 100644 --- a/Documentation/admin-guide/mm/damon/usage.rst +++ b/Documentation/admin-guide/mm/damon/usage.rst @@ -6,6 +6,11 @@ Detailed Usages =20 DAMON provides below interfaces for different users. =20 +- *Special-purpose DAMON modules.* + :ref:`This ` is for people who are buildi= ng, + distributing, and/or administrating the kernel with special-purpose DAMON + usages. Using this, users can use DAMON's major features for the given + purposes in build, boot, or runtime in simple ways. - *DAMON user space tool.* `This `_ is for privileged people suc= h as system administrators who want a just-working human-friendly interface. diff --git a/Documentation/mm/damon/design.rst b/Documentation/mm/damon/des= ign.rst index c10a3dea3aa8..dd64f5d7f319 100644 --- a/Documentation/mm/damon/design.rst +++ b/Documentation/mm/damon/design.rst @@ -817,6 +817,8 @@ available. Please refer to the ABI :ref:`doc ` for details of the interfaces. =20 =20 +.. _damon_modules_special_purpose: + Special-Purpose Access-aware Kernel Modules ------------------------------------------- =20 --=20 2.47.3 From nobody Sat Feb 7 18:16:05 2026 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id DF0153009E2; Sun, 18 Jan 2026 18:03:13 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1768759393; cv=none; b=kOSYDGHb9WZRBZWjwoEBQKGKvdvxxBOkAyICDfDdxrPqYkLVH2K9L8fEJCIt/kX8WgI7G6PbkNi4KcVNrgR/AGoPVPCCKzE9aNOGMeYb5Xwp+zZyAT+g8k1JUO2boC0m+VtciiLXfH1Fol78OgDiv4+WxsuPHQhZaItSZTsD6aw= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1768759393; c=relaxed/simple; bh=LR2wVWJnzRZMCJ1oBYDVY/vPM/T4H4yu0kot6/rnmTs=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=tmw2LwgeHeJy/Owi5cYEUSFMFpWGrrRtnOpldXea10WxW94YW+v55H3Cg5fFzrkc7iICekFf+s9Vqm1B08ge+Re4ieJa4hdPxlJePQ7xkDpGNNm/bJt1NaoS2dDynpfrPiVB7UPrfygFtvGZONHkA2+3WTHrUPmTXkWoypOWpCU= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=sdCnazW/; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="sdCnazW/" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 89E93C2BC86; Sun, 18 Jan 2026 18:03:13 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1768759393; bh=LR2wVWJnzRZMCJ1oBYDVY/vPM/T4H4yu0kot6/rnmTs=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=sdCnazW/iIGK36SFyGPzvBHD29cEX9ttdnrNaE+GY7XHtI6UxTm3t2YCzci4GXHU3 vzCudRiBsmKfqUwW5Ub4hXwIua5SZa/mjLQ1NjR/Q87CCqXqcPWE4e4ZFj6+NrG8es 0aogOxs3l2lkit5tFm53tRQ5kPu/PYEhvPLRKyFR1GWYKiJI/Kt4N9AD9V8/5djkd5 +T0RcfIKXCj5TVZOCqD5scmxvhmqCHe8IiTwHpZJZPEkaPYmZz/itsDH/UKvOEyMrn P3PXh3buPg2Yx3zJxQkincSsN7OrG2fnnrGgJGfSXdofiqKMVzjRebCB8cMKBTqPCI sncP347ZYAnOw== From: SeongJae Park To: Andrew Morton Cc: SeongJae Park , "Liam R. Howlett" , David Hildenbrand , Jonathan Corbet , Lorenzo Stoakes , Michal Hocko , Mike Rapoport , Suren Baghdasaryan , Vlastimil Babka , damon@lists.linux.dev, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-mm@kvack.org Subject: [PATCH 6/8] Docs/admin-guide/mm/damon/usage: update stats update process for refresh_ms Date: Sun, 18 Jan 2026 10:02:57 -0800 Message-ID: <20260118180305.70023-7-sj@kernel.org> X-Mailer: git-send-email 2.47.3 In-Reply-To: <20260118180305.70023-1-sj@kernel.org> References: <20260118180305.70023-1-sj@kernel.org> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" DAMOS stats on sysfs was only manually updated. Recent addition of 'refresh_ms' knob enabled periodic and automated updates of the stats. The document for stats update process is not updated for the change, however. Update. Signed-off-by: SeongJae Park --- Documentation/admin-guide/mm/damon/usage.rst | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/Documentation/admin-guide/mm/damon/usage.rst b/Documentation/a= dmin-guide/mm/damon/usage.rst index bfaee977c37c..b0f3969b6b3b 100644 --- a/Documentation/admin-guide/mm/damon/usage.rst +++ b/Documentation/admin-guide/mm/damon/usage.rst @@ -549,10 +549,13 @@ online analysis or tuning of the schemes. Refer to := ref:`design doc The statistics can be retrieved by reading the files under ``stats`` direc= tory (``nr_tried``, ``sz_tried``, ``nr_applied``, ``sz_applied``, ``sz_ops_filter_passed``, ``qt_exceeds``, ``nr_snapshots`` and -``max_nr_snapshots``), respectively. The files are not updated in real ti= me, -so you should ask DAMON sysfs interface to update the content of the files= for -the stats by writing a special keyword, ``update_schemes_stats`` to the -relevant ``kdamonds//state`` file. +``max_nr_snapshots``), respectively. + +The files are not updated in real time by default. Users should ask DAMON +sysfs interface to periodically update those using ``refresh_ms``, or do a= one +time update by writing a special keyword, ``update_schemes_stats`` to the +relevant ``kdamonds//state`` file. Refer to :ref:`kdamond directory +` for more details. =20 .. _sysfs_schemes_tried_regions: =20 --=20 2.47.3 From nobody Sat Feb 7 18:16:05 2026 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 68D16301493; Sun, 18 Jan 2026 18:03:14 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1768759394; cv=none; b=YFHFJTm+6bHAfF4NM4BT/YiPrMAwG6O2ApWM7vW5XcDqCqz8kQWoXgLLUT58hpkGl2ORAJMQTtpAkM6EcJnZ+psqoYmRWr4S84IPMtQyg7cm09p+DsRkavnkjSEzVImGOZ5oCMLOLSslP9H2xXZUHZBOQlpZy1+g12H9v00ApCs= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1768759394; c=relaxed/simple; bh=1GRiXmsO65OYbfT1UpFoUJRXTsmQCXqwNCyc2P2HEi8=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=J+tEC1nkgtrZha4XjdQwrntTM+/qqMBmtI29It0bVp0F/+gzZDBgSoBq/qmuD3kR4QGd9agQT/PO5kKZkrVtN2gBbp+tlM9hywkiwVGdepam6USnWH+F9jAaxhc/SPFRMGDhKjCe92uX9XhtdBuGbcc/T+P34AUIfX+kCYGbTrA= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=ewvwYXCI; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="ewvwYXCI" Received: by smtp.kernel.org (Postfix) with ESMTPSA id E206DC116D0; Sun, 18 Jan 2026 18:03:13 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1768759394; bh=1GRiXmsO65OYbfT1UpFoUJRXTsmQCXqwNCyc2P2HEi8=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=ewvwYXCI0UNZ/JjJAkjbGBLsGZjO414jRL6prWYBB8Pa9s8HysdJrNQwhL73sx3m+ ysed0jEyD+/qkThI/MhqbaYOJlR28ZO0SD7VRrSvI4GFwnmAeG3rpYRlC3pvkcwX3h F9KY8x5EhL8yyGCX7ijt3lrQGQI0w/PwVN7E0Cvm2iYuKwejd2T7S+g3WAcyb7jpom ZgLvgKbkLXd2T6QMNUJqbQL1sHS29cpaVjhMZA/dIfLn4l5D2eiwlh3CIdOc9hEv/0 n77vsWspqZaYxIl1CslTUChb6B4H7iAtHjF+oAbb7fMIU3L+smo2M7GMC8K4sCU1vj d89MLT1AsQE8g== From: SeongJae Park To: Andrew Morton Cc: SeongJae Park , "Liam R. Howlett" , David Hildenbrand , Jonathan Corbet , Lorenzo Stoakes , Michal Hocko , Mike Rapoport , Suren Baghdasaryan , Vlastimil Babka , damon@lists.linux.dev, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-mm@kvack.org Subject: [PATCH 7/8] Docs/mm/damon/maintainer-profile: fix wrong MAITNAINERS section name Date: Sun, 18 Jan 2026 10:02:58 -0800 Message-ID: <20260118180305.70023-8-sj@kernel.org> X-Mailer: git-send-email 2.47.3 In-Reply-To: <20260118180305.70023-1-sj@kernel.org> References: <20260118180305.70023-1-sj@kernel.org> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Commit 9044cbe50a70 ("MAINTAINERS: rename DAMON section") renamed the section for DAMON from "DATA ACCESS MONITOR" to "DAMON". But the commit forgot updating the name on the maintainer-profile document. Update. Signed-off-by: SeongJae Park --- Documentation/mm/damon/maintainer-profile.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Documentation/mm/damon/maintainer-profile.rst b/Documentation/= mm/damon/maintainer-profile.rst index e761edada1e9..4fa06b21ec30 100644 --- a/Documentation/mm/damon/maintainer-profile.rst +++ b/Documentation/mm/damon/maintainer-profile.rst @@ -3,8 +3,8 @@ 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 =20 -The DAMON subsystem covers the files that are listed in 'DATA ACCESS MONIT= OR' -section of 'MAINTAINERS' file. +The DAMON subsystem covers the files that are listed in 'DAMON' section of +'MAINTAINERS' file. =20 The mailing lists for the subsystem are damon@lists.linux.dev and linux-mm@kvack.org. Patches should be made against the `mm-new tree --=20 2.47.3 From nobody Sat Feb 7 18:16:05 2026 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id ABFC63019DC; Sun, 18 Jan 2026 18:03:14 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1768759394; cv=none; b=narP6HV0dgOUZeCDGhI0unsV+s3I3PLvI75d3x3TvUXI/dmwgnNGWvgeKRI4GCpGtdCrImo012kBWngpJ7gUjhPPXL5VwXj1w/DCu4QbS0rNUPk8or2wPz/kJ8TtL5VzdFX/zOs9XMT0aChdV0AlvmakFaN7cC1e1O+8EW/Tw84= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1768759394; c=relaxed/simple; bh=z3Zk/jJdUa1YP5N4FiUh/fhzLI3wr0WgwfqrSYYQ9/Y=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=ErvgxF7IYofFoaq6tFupMwupEU3soB1g6/aBjlwA1fo9m4SD9yJqWLOKruoK1jH+FTXlBygxia+IacMBSSn0Hldkg+9BTG+JvebSahfWXtif/VXchBCE1PDQZWFB2u1BhmZA3HzGR3+CveBbMnMFYtve7xsEdsbUzvZ5jYbBbf0= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=aV9+A/Tj; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="aV9+A/Tj" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 487CDC2BC86; Sun, 18 Jan 2026 18:03:14 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1768759394; bh=z3Zk/jJdUa1YP5N4FiUh/fhzLI3wr0WgwfqrSYYQ9/Y=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=aV9+A/Tj2q1TX85Kvgou1yTr2rX8pG4GZCqHcC43bHHnXvnhCMN55xe0yC4RLpH3R AuGH1mSPhLXa2LnTX+HmuCvrLcwrXTC1ZiR8N8lnssMwtiFhf/xFQ/rxD/EA/z4mFJ OGaWsvs7+uE44Ed8UiKsJqEWis3/CMFf5HIQZrC+zRxMN28/y7qX872Px51Ag9TAKD 3YhggbDuE9tnjGgECcOApWRtgF4Onitp4AAoEgIFunMk/rfh+nJ7CwuMeH3PMY+jlw 02HqkCAEglLbmCzFuElojYT57sxYAVVROePpAyxUDXWJNANEhX1QWAD3OREp2mv2OH SCRuguUrfsNTg== From: SeongJae Park To: Andrew Morton Cc: SeongJae Park , "Liam R. Howlett" , David Hildenbrand , Jonathan Corbet , Lorenzo Stoakes , Michal Hocko , Mike Rapoport , Suren Baghdasaryan , Vlastimil Babka , damon@lists.linux.dev, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-mm@kvack.org Subject: [PATCH 8/8] Docs/mm/damon/maintainer-profile: remove damon-tests/perf suggestion Date: Sun, 18 Jan 2026 10:02:59 -0800 Message-ID: <20260118180305.70023-9-sj@kernel.org> X-Mailer: git-send-email 2.47.3 In-Reply-To: <20260118180305.70023-1-sj@kernel.org> References: <20260118180305.70023-1-sj@kernel.org> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" The DAMON performance tests [1] use PARSEC 3.0 as its major test workloads. But the official web site for PARSEC 3.0 has gone, so there is no easy way to get the benchmark. Mainly due to the fact, DAMON performance tests are difficult to run, and effectively broken. Do not request running it for now. Instead, suggest running any benchmarks or real world workloads that make sense for performance changes. [1] https://github.com/damonitor/damon-tests/tree/master/perf Signed-off-by: SeongJae Park --- Documentation/mm/damon/maintainer-profile.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/Documentation/mm/damon/maintainer-profile.rst b/Documentation/= mm/damon/maintainer-profile.rst index 4fa06b21ec30..41b1d73b9bd7 100644 --- a/Documentation/mm/damon/maintainer-profile.rst +++ b/Documentation/mm/damon/maintainer-profile.rst @@ -48,8 +48,7 @@ Further doing below and putting the results will be helpf= ul. - Run `damon-tests/corr `_ for normal changes. -- Run `damon-tests/perf - `_ for perfor= mance +- Measure impacts on benchmarks or real world workloads for performance changes. =20 Key cycle dates --=20 2.47.3