From patchwork Sat Feb 17 00:58:38 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 13561139 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 4B5D0C48260 for ; Sat, 17 Feb 2024 00:58:51 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 645A66B007B; Fri, 16 Feb 2024 19:58:50 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 5F5A66B007D; Fri, 16 Feb 2024 19:58:50 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 4E47B6B0085; Fri, 16 Feb 2024 19:58:50 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0014.hostedemail.com [216.40.44.14]) by kanga.kvack.org (Postfix) with ESMTP id 3D4616B007B for ; Fri, 16 Feb 2024 19:58:50 -0500 (EST) Received: from smtpin11.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay01.hostedemail.com (Postfix) with ESMTP id 0CFFF1C002C for ; Sat, 17 Feb 2024 00:58:50 +0000 (UTC) X-FDA: 81799486020.11.BB529F0 Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by imf09.hostedemail.com (Postfix) with ESMTP id 6CE8A140006 for ; Sat, 17 Feb 2024 00:58:48 +0000 (UTC) Authentication-Results: imf09.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=sAnP8Y39; dmarc=pass (policy=none) header.from=kernel.org; spf=pass (imf09.hostedemail.com: domain of sj@kernel.org designates 139.178.84.217 as permitted sender) smtp.mailfrom=sj@kernel.org ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1708131528; a=rsa-sha256; cv=none; b=jb+0SPPldtJQQxvxDqkjrrn0cGm0GfCjmAorscw6/tkwBM/j5QwC8jZjCqnKlDl8dwcQo/ qwV7v+1W7eWz2hGQJW8t/uXCVAYUSZnVAte9OE+3XcMlLdS21uWU/n33IWjLk7h3QQf5J3 BNPxw5Ke2HHjXzRd2hcou9rxHiSYja8= ARC-Authentication-Results: i=1; imf09.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=sAnP8Y39; dmarc=pass (policy=none) header.from=kernel.org; spf=pass (imf09.hostedemail.com: domain of sj@kernel.org designates 139.178.84.217 as permitted sender) smtp.mailfrom=sj@kernel.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1708131528; 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=bI4Sh5OJOcqb8lUNVDYtGA3aqdSh4OYOhW5DJRNgYTY=; b=mCab9Hh9Iyw8VqVfbqhM5/PdsM3ZxoWYRVB/rAYgDV18hUKmj7hSDiojP7hdINHB5l9pLI t5odWf3mZDOt2FxIVnq00f/M6/t/0iVfJT1I8HKZajM2pPVzaxzGav4ig6+QmCWH+WSjkd QeY2Grjfc0v/UWnWB/8i74bhIE2x+Zc= Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by dfw.source.kernel.org (Postfix) with ESMTP id 6C8BB62117; Sat, 17 Feb 2024 00:58:47 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 9018EC4160D; Sat, 17 Feb 2024 00:58:46 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1708131527; bh=Amv7MsMRrFhTpSKvV6b53ASGSJnoAb83web7cZHL2Xc=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=sAnP8Y392axNOEc8YRW/0sLDcxwLLHJPPXLuM6vPeVUqHE9FZZ/BorXpOA8r46Lfe aZFCAYNsDJYrS2BSgzsvoHGCGNdYJwdwkZCXotxUD+CrxbXlossn69i4lNDZDDN9/S qauCf0OHvQfTTOGIw7WEGv+QabZEoJiePobg1Iv1ZlICP+jxERy+4cqGy9v0tqXoRp xff7mNIotAANdwocgZQ5Ap6kzQs3DuaXmJwU5j0xOURVwc9cGhqGxAD3GGTcOE9lpg ZmA34gsmsrJ9cJ4Bhhbbezp0nsFTU+wZcYyV9lG9IPuHGrsll0j6aelOHeoESW634c xNlHDVxJQYEZw== 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 1/5] Docs/mm/damon/maintainer-profile: fix reference links for mm-[un]stable tree Date: Fri, 16 Feb 2024 16:58:38 -0800 Message-Id: <20240217005842.87348-2-sj@kernel.org> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20240217005842.87348-1-sj@kernel.org> References: <20240217005842.87348-1-sj@kernel.org> MIME-Version: 1.0 X-Rspam-User: X-Rspamd-Server: rspam06 X-Rspamd-Queue-Id: 6CE8A140006 X-Stat-Signature: q1gc1gj7ktjmberxjsz7xmsjxyec41b9 X-HE-Tag: 1708131528-623334 X-HE-Meta: U2FsdGVkX1+jgkjegVXe04hgY4yHaUGRSTsP/9OJxUxGGscXZY6G4kyc76pQxbX0Z0XGQqhQFrySBOM9eJ1iF7og8L4IFKooeh05ncPeRlifS6TZPQ29vVXUUHwyIFoOgxMcCCDE369zZMNE7Sow/M21/ZubxHmY45PvMwSPFWlp5I0yHX4wczFez+e9gjwsHiU0SOvXJmlzNGJlJkXBwJ1GtsgZoknP+q2/7C5rFQUUW7XByQhBKBPTlWRTrbmNuMUKvNhgkUJX5JlhBBeW9Raknwt6aFPbxdendK0Pw4fF+PqZAro/wpu49/oMsstPcREDY3TWf3g+/z1UaKpbvq13NtWkvBbDYrm0oQuFKz386VB9yA+UCDv8VbrXhhsbEtbe9vdYr3jW4A93KB0fw2Bx/UjAaXkplnShHviRT9/EBpzBKmaNXPsfRBBbCXBopLGngSQfEp63lDzhzN/bUVdcSxRiqqA6mSR5ar2EsXtlZj/vVxhjFpG6bV2L53er84DwPCMOfRywzlDjWBefnM19x32cFsx6EqawFMihdfqD3b6zDQRks1eXJ3LP68pU/dHjQXEHfW+1DsTNGu3UCyaAqD+Bep6/bqVEq0M6J2FPUWLcTWpbUxi+ScKsUC3elbJtRi8OV+dvO124uJB0z017Rys+Lup9cYEFk13IbQaFYy5n3jvd4sY8B/BGYjJ6E2nZc5yyfRUI09q3WlvyrEAFdkw/AqDg78M9SI+pmCUpAvHOURAQYoFkptkKzIf8jWNNbFJKhPJX6U/k+21OdOVPWH16UjVMvuWRQw4Dt4lib2LzLQYzIgfZNEJDY0GEI2F86lNF+THU/LQ8o5RlCt0kblH3U/mVJtlDwIovDqDepcYBJy3TarQdZk/zUNMStQl/xCi6Upm5jVIcJZFRqd8MVDxRxXltl5VX8+TodlTpChM6JgwUMguwhVcakrHsC3s8s9D9/A69a1LqMQ3 4OCtCUcl Iwqj0sEmesCPtse3rt/z2jOEuormclAoxQcbYlgdUFVlTJo8GlIuc3CNezfwzMbapcMx8HYybnl1YzdbjASHRHxoh6xDeDvytNU4daccz6/ryk7PLqRio662wGf0q9rho+2xOfY+xwTx3xBmPdFNOGul11DqwXdQFXStVra8RFczSwCL2o8QqMXj+XHcrg062mPW5HijaRatfhu21x8KKrCd2fBrr9j17OJ754Avevd8Tu2Q= 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: A couplt of sentences on maintainer-profile.rst are having reference links for mm-unstable and mm-stable trees with wrong rst markup. Fix those. Signed-off-by: SeongJae Park --- Documentation/mm/damon/maintainer-profile.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/Documentation/mm/damon/maintainer-profile.rst b/Documentation/mm/damon/maintainer-profile.rst index a84c14e59053..5a306e4de22e 100644 --- a/Documentation/mm/damon/maintainer-profile.rst +++ b/Documentation/mm/damon/maintainer-profile.rst @@ -21,8 +21,8 @@ be queued in mm-stable [3]_ , and finally pull-requested to the mainline by 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' works in -progress. +tree [1]_ whenever possible. damon/next is only for preview of others' works +in progress. Submit checklist addendum ------------------------- @@ -41,8 +41,8 @@ Further doing below and putting the results will be helpful. 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. +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 -------------- From patchwork Sat Feb 17 00:58:39 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 13561143 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 96011C48BF6 for ; Sat, 17 Feb 2024 00:59:00 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id A8D0E6B0092; Fri, 16 Feb 2024 19:58:54 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id A3E216B0093; Fri, 16 Feb 2024 19:58:54 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 8DC6C6B0096; Fri, 16 Feb 2024 19:58:54 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0015.hostedemail.com [216.40.44.15]) by kanga.kvack.org (Postfix) with ESMTP id 7997D6B0092 for ; Fri, 16 Feb 2024 19:58:54 -0500 (EST) Received: from smtpin18.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay05.hostedemail.com (Postfix) with ESMTP id 20A9B4011E for ; Sat, 17 Feb 2024 00:58:54 +0000 (UTC) X-FDA: 81799486188.18.BA632B8 Received: from sin.source.kernel.org (sin.source.kernel.org [145.40.73.55]) by imf03.hostedemail.com (Postfix) with ESMTP id D29DE20003 for ; Sat, 17 Feb 2024 00:58:51 +0000 (UTC) Authentication-Results: imf03.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=ab1s7a8Z; dmarc=pass (policy=none) header.from=kernel.org; spf=pass (imf03.hostedemail.com: domain of sj@kernel.org designates 145.40.73.55 as permitted sender) smtp.mailfrom=sj@kernel.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1708131532; 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=rkytF4J4Jg9lwSSrwHvDWXBUGqs0QkBT9IVd0tsJCJ4=; b=PGjPX1IzswvzsGIN2qFRN9Mp9ATWJN04ZWiWKcjtNgDSeX9AE11tSjyy3sqbfozZ74gbhS G2S3ULVuGg6zfcvJC6yUvaomUIcLTnk3Mb9/h60bMahI7X3vPsVv+liqv9WlLZpq1q0lLF b+gVIRJadquybiWbioRkOyluhMffpLk= ARC-Authentication-Results: i=1; imf03.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=ab1s7a8Z; dmarc=pass (policy=none) header.from=kernel.org; spf=pass (imf03.hostedemail.com: domain of sj@kernel.org designates 145.40.73.55 as permitted sender) smtp.mailfrom=sj@kernel.org ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1708131532; a=rsa-sha256; cv=none; b=C64mDQQvKQZnFJ9EYYKW/L6aA+QNlm5t7v9Fzk3QfO4TjkTGXt+oG0drSeZm/EE/IcspLl 8Ka4perql3qpotodhp182tfYSK+C+1nfFruqMxPTo9vS9t82CEXMYOZpGXqZ+Rd4vR1AIE XL/cR+lTgOPXuYVcWVcsgbdh0cG9BQA= Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by sin.source.kernel.org (Postfix) with ESMTP id C1798CE2D74; Sat, 17 Feb 2024 00:58:48 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 6A969C43394; Sat, 17 Feb 2024 00:58:47 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1708131528; bh=ZF7Ys29G8g/k6D1jFHkNld6ID7JrPCUQzMebjrLS5cc=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=ab1s7a8ZVMd65Gov613sVFUA9Z1HOsB0ADjuIBE2ac+9N/3GFt/fZ3Jh3yqR3KlAU ZBCbYFIJ/7sYSlVdaUALdwiw7n5Vz70vwWf/AMYu6WrYE30mAQ5MznaR6kRP2y/VwZ eApMMw8nps4ukwaCWHjwmqguvLzL6Z7xRQBAmFLZfPLPv5aG9wQAYvZvMcvBsKcOTQ go4PJwvFy2JnFHrjrtignzt40wD0jMQVyWcqbkCYt37sb71r90hFvv3Ib8T5u9ZP9w P1SYlEYr2cLkqkL8Q/QYAVJOpFM2r/ZPc5tslHjzZIMxnD2DQGrKbNzR5QMRQkwm0G TEa6NN702cKYQ== 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 2/5] Docs/mm/damon: move the list of DAMOS actions to design doc Date: Fri, 16 Feb 2024 16:58:39 -0800 Message-Id: <20240217005842.87348-3-sj@kernel.org> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20240217005842.87348-1-sj@kernel.org> References: <20240217005842.87348-1-sj@kernel.org> MIME-Version: 1.0 X-Rspamd-Queue-Id: D29DE20003 X-Rspam-User: X-Rspamd-Server: rspam04 X-Stat-Signature: 53oniehdbs7ppff6mjg1yt8hqx8gf58z X-HE-Tag: 1708131531-7676 X-HE-Meta: U2FsdGVkX18uLmyOQlqeEnXo3PDsnCUrdL2kQDk6jIVp0pBFYQOqVFHgG0qWUOREinD0CIGVk5b/J4tJwQAoyAEhVPsZwcha951X3/eLg9F8NOGDQwdIoZ6Grd4W04oWzIpIA1xN5P+76Tb10kMSkkrY3uWyTFgUtaewq59/zsKfVllJcFljQEh5cVYD8xbAEqvKp2RCZyLTKx/X5j8zk3x/dSLCaNDBGv4GbeBZyA7W8s7cy/Pv3AYO/b/WbQThm1XGEJEbeulwX3iK5w3yRWTRRO5d57Fguhy7CWtV8Egkq0jQ72OUiSpJSisjAkKOsY3nbB2rZWl5wEd9oJRlyWKxnhO7eUzFIzmEQbXaaG4EiotxdItomGEjZGz+E0SAsYzb18cU6f8u9W30vXYMAQgPTJ2NVOTVVQ06Lu5Q1jg7go2Tma4/mT14UfpLtO5YMdEqmys50WU/74UF4bDfthMV1xA9kB7MNiqr8XJLfk6S4N7sRoZdVhAM0nA0Riuuvdf/ErWVWC+Ns2CrcCF5qcU9TFwEOABYCR+kqSHOvHUDjayAUbgeEMoN5+JpOm8UTFHoJW7jEhPuhYwRd8xSM5wAANE6cY4cGj1qsP4L7B6GCCRpsr9oymxGzcrvwEv9kOnWGONCDXpUa00uJ1VPIAy5k5hwagDnZDtb4SK4Se+q8P3Om25OcHMZV/GdDskWsCo+ckf3zOUJoVBIRtpDK05X2ZYHdcFXNQyAhm2uEvEy5PW2QXmDJkH5foJ7K2dttNMCRuonJAWv3xD+fizGefeGZbS25QZdpSYmC244z/i0Sjc8FJuB+A0/OWKyHqAiuChGO1o9bWQILx3KsLZabF8VJp5v4OCCBwws4cEoTbrC16aex7w6TgSHitTEoYQAkB9CmJ/XDHDuqenzgXCrbT6nJ4WYk2J5HHET6kRj+lif2yzcNB4n50rZhl3sVHpKUKKcxU+/5Ui8olkj+Qc qOxevt+A hfEl+6zTco+H3okCsYg14oYHFtefm62BrbJ8Dw5PVMvomoAHckTFt9CXtlsxu3d2tiOGS7ZNDt8nIFdmSd63O6ty48ylND3sWHFJGJjIZB+x4XpJOj7movAU2HYaPeZcmv3MeDIs6X9HPYBYkBVFqa8OHN8wuqZAzRp2uNMZUtIPuUOqweu0t0/WJ64J8sItzpLAOnGsw54vNJnbL/p51tc1i4+ApGS9kdJsfcOPf7MnLPxLjNXRAKMSIdGgrWoNuejDLMy50e2juAD8= X-Bogosity: Ham, tests=bogofilter, spamicity=0.000005, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: List-Subscribe: List-Unsubscribe: DAMOS operation actions are explained nearly twice on the DAMON usage document, once for the sysfs interface, and then again for the debugfs interface. Duplication is bad. Also it would better to keep this kind of concept level details in design document and keep the usage document small and focus on only the usage. Move the list to design document and update usage document to reference it. Signed-off-by: SeongJae Park --- Documentation/admin-guide/mm/damon/usage.rst | 47 ++++++-------------- Documentation/mm/damon/design.rst | 26 +++++++++-- 2 files changed, 36 insertions(+), 37 deletions(-) diff --git a/Documentation/admin-guide/mm/damon/usage.rst b/Documentation/admin-guide/mm/damon/usage.rst index 58c34e66b31b..0335d584956b 100644 --- a/Documentation/admin-guide/mm/damon/usage.rst +++ b/Documentation/admin-guide/mm/damon/usage.rst @@ -302,27 +302,8 @@ In each scheme directory, five directories (``access_pattern``, ``quotas``, The ``action`` file is for setting and getting the scheme's :ref:`action `. The keywords that can be written to and read -from the file and their meaning are as below. - -Note that support of each action depends on the running DAMON operations set -:ref:`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_NOHUGEPAGE``. - 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. - Supported by ``paddr`` operations set. - - ``stat``: Do nothing but count the statistics. - Supported by all operations sets. +from the file and their meaning are same to those of the list on +:ref:`design doc `. The ``apply_interval_us`` file is for setting and getting the scheme's :ref:`apply_interval ` in microseconds. @@ -763,19 +744,17 @@ Action ~~~~~~ The ```` is a predefined integer for memory management :ref:`actions -`. The supported numbers and their meanings are as -below. - - - 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 +`. The mapping between the ```` values and +the memory management actions is as below. For the detailed meaning of the +action and DAMON operations set supporting each action, please refer to the +list on :ref:`design doc `. + + - 0: ``willneed`` + - 1: ``cold`` + - 2: ``pageout`` + - 3: ``hugepage`` + - 4: ``nohugepage`` + - 5: ``stat`` Quota ~~~~~ diff --git a/Documentation/mm/damon/design.rst b/Documentation/mm/damon/design.rst index 1bb69524a62e..9f16c4e62e72 100644 --- a/Documentation/mm/damon/design.rst +++ b/Documentation/mm/damon/design.rst @@ -294,9 +294,29 @@ not mandated to support all actions of the list. Hence, the availability of specific DAMOS action depends on what operations set is selected to be used together. -Applying an action to a region is considered as changing the region's -characteristics. Hence, DAMOS resets the age of regions when an action is -applied to those. +The list of the supported actions, their meaning, and DAMON operations sets +that supports each action are as below. + + - ``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_NOHUGEPAGE``. + 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. + Supported by ``paddr`` operations set. + - ``stat``: Do nothing but count the statistics. + Supported by all operations sets. + +Applying the actions except ``stat`` to a region is considered as changing the +region's characteristics. Hence, DAMOS resets the age of regions when any such +actions are applied to those. .. _damon_design_damos_access_pattern: From patchwork Sat Feb 17 00:58:40 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 13561142 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 99F2EC48260 for ; Sat, 17 Feb 2024 00:58:57 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 782476B008C; Fri, 16 Feb 2024 19:58:53 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 6B91D6B0092; Fri, 16 Feb 2024 19:58:53 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 534596B0093; Fri, 16 Feb 2024 19:58:53 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0010.hostedemail.com [216.40.44.10]) by kanga.kvack.org (Postfix) with ESMTP id 40A3D6B008C for ; Fri, 16 Feb 2024 19:58:53 -0500 (EST) Received: from smtpin30.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay09.hostedemail.com (Postfix) with ESMTP id 4E99A80119 for ; Sat, 17 Feb 2024 00:58:52 +0000 (UTC) X-FDA: 81799486104.30.FFD4738 Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by imf19.hostedemail.com (Postfix) with ESMTP id BC3441A000F for ; Sat, 17 Feb 2024 00:58:49 +0000 (UTC) Authentication-Results: imf19.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=V1LRIars; dmarc=pass (policy=none) header.from=kernel.org; spf=pass (imf19.hostedemail.com: domain of sj@kernel.org designates 139.178.84.217 as permitted sender) smtp.mailfrom=sj@kernel.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1708131529; 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=vmxiajUirsBDl1M6sqXQnv4umdkdvmXO8tcQkVWhVto=; b=acaiLD3nsC/mv7MuO1RBphIaJW7FctcSQIsKHsHdEjBtJl/BAd8b+K0jlO2cczzGBLEA76 ULFVWYzAI2vYAhjhR8TPiFq8YV4djWFXIHCGvKeLM4BwdKbn6LzNjKvK77+LNeG3zCZL/v v3QuKSTMAh7mgO3zL1/LWfLy4y2al10= ARC-Authentication-Results: i=1; imf19.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=V1LRIars; dmarc=pass (policy=none) header.from=kernel.org; spf=pass (imf19.hostedemail.com: domain of sj@kernel.org designates 139.178.84.217 as permitted sender) smtp.mailfrom=sj@kernel.org ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1708131529; a=rsa-sha256; cv=none; b=OANFgbe71149rKXMJMQ+JPVDvBeXeOAFz6tr/YLh4wcKe2PUdLSshe8fn2EG5BE7Ml6Q4w LmgKOk6FwuS38SoS5MhIZyzvPvY+w8MHBfOWdPf6LL1l6Mq49j3F7dTXMUhNURiRh8sXXM fMmuhdBDVNPRIvt6TsPObzgHDizWssM= Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by dfw.source.kernel.org (Postfix) with ESMTP id 039566208F; Sat, 17 Feb 2024 00:58:49 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 3E7F1C43390; Sat, 17 Feb 2024 00:58:48 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1708131528; bh=PHukevGUaPQZ0Um8hgVXJLMqOMYMR4EFewceSXfTR20=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=V1LRIarsi4JEdp5awudjc8ZjiK4TTDFQvBacB7HgvC9og6SplSDfSj8p9vx7Nj1vU MXt6mtUIt/A3GuCr60Kt4C+LT1P/BFtsSq+1sFP5SzhpblfgpDJHEx1coctwHfxF4Y 1aflAnUaAPr8y286nDAaC2Bx03T5qXXnXP06wYAtuL//9xKsm8/mbH/ZdM2H3zWRAm 4fW0ZDYAO0hI2FGOwq5MynjPnqmI6ulZsgjSumQuTmBN1vesW0pIRAvRFhu216FWyw w0N6B3qOo/dajkSf/2tCIL8phQRnHhfS9cwp+sb++optf0lUc91VHsTIbSMYg2mbVc vi47D6ILa3s6g== 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/5] Docs/mm/damon: move DAMON operation sets list from the usage to the design document Date: Fri, 16 Feb 2024 16:58:40 -0800 Message-Id: <20240217005842.87348-4-sj@kernel.org> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20240217005842.87348-1-sj@kernel.org> References: <20240217005842.87348-1-sj@kernel.org> MIME-Version: 1.0 X-Rspamd-Queue-Id: BC3441A000F X-Rspam-User: X-Rspamd-Server: rspam05 X-Stat-Signature: 3o76e3skm95zmmj9nsyb96mzm5tycbyd X-HE-Tag: 1708131529-509958 X-HE-Meta: U2FsdGVkX19vELmYXjiVlcAuFsJfoVBMSU3dg+LNFy6zgI7S1kyvSJF7MN9DShElMZBGM35ln5x/0aJIEUkuVc/jv1auAjsrUwlLdpAJi3LSuhAfNQc2/tNG76IBXbRVAtg+i4+lP9RxqSreFS9WBVf3cRGCWo2zEpOSY+Mz7z3qCs67fjZdzkdRPREgZjS7NjGa9oZiNqlLu80lYygOogOaakGB6UnCsRd8H75aOgfsghGB25PYc07XY9cnHTZlPjef0Tfx/gWrTkG8c9kYTL+u+09B/3J+q5O1LSQAYRP6Bh/y3IIlQN6j4fVS/dlB0jSxmNFx3W3ueOWKvooRpQSHlsVPjNu3cyRBXwWgbjWl2Dsegl/p9rMYblhzKpb9wqdJEbZcsJTuYWlRDNoNCCHLO7yalhTM/6Jp+6U0bnUjG7siVdwP9FgRatchm2W6JyZ17iG3t0Zoa+cPniws98HzwPeqq9HNuK5atoL24kPcAKATeCKJyoaP/FD5ly3hJwJ4THrrxbv0TS1GR2cHSH239/EmzqixfjxMAlPmNQyPbJS1oAmUAalBFqmeYrDbPggWb3L1+3TG/mtjrxR1PwkhISRh1CO/7Z6qnG42cuhicrWvFBWIQBnggR9D6Ku34X5CQjbIxwVFuvC88o2eQ7iWw95GJrgtTNNgPr1lozfhMHkqxIV/+BEmxvpf39uB8H9G+PKsemq4E1uEkhSi5ujlTlZkTgdBDZKwoBAut0fDI6gXW5Fvg4HHcF/A0dtS7CvbUw0ewojEC7AD5Ol0eCjzASpeHP8q7HRzVCV0yc8W7PSkEOGhSJ+G0jXQrd8x1n++kZV/qL3dWY4SvAnS43SHECb5Huw/m1tsZm0MURXM0r96PC0s11tPNGxUTmkWiex2jW+tweNzMoAokDbrDejqnhXiTbwA9j0GgpITmaR1fS4x0K6bWg== 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 list of DAMON operation sets and their explanation, which may better to be on design document, is written on the usage document. Move the detail to design document and make the usage document only reference the design document. Signed-off-by: SeongJae Park --- Documentation/admin-guide/mm/damon/usage.rst | 19 +++++++------------ Documentation/mm/damon/design.rst | 12 ++++++++++-- 2 files changed, 17 insertions(+), 14 deletions(-) diff --git a/Documentation/admin-guide/mm/damon/usage.rst b/Documentation/admin-guide/mm/damon/usage.rst index 0335d584956b..be0924f47a42 100644 --- a/Documentation/admin-guide/mm/damon/usage.rst +++ b/Documentation/admin-guide/mm/damon/usage.rst @@ -180,19 +180,14 @@ In each context directory, two files (``avail_operations`` and ``operations``) and three directories (``monitoring_attrs``, ``targets``, and ``schemes``) exist. -DAMON supports multiple types of monitoring operations, including those for -virtual address space and the physical address space. You can get the list of -available monitoring operations set on the currently running kernel by reading +DAMON supports multiple types of :ref:`monitoring operations +`, including those for virtual address +space and the physical address space. You can get the list of available +monitoring operations set on the currently running kernel by reading ``avail_operations`` file. Based on the kernel configuration, the file will -list some or all of below keywords. - - - vaddr: Monitor virtual address spaces of specific processes - - fvaddr: Monitor fixed virtual address ranges - - paddr: Monitor the physical address space of the system - -Please refer to :ref:`regions sysfs directory ` for detailed -differences between the operations sets in terms of the monitoring target -regions. +list different available operation sets. Please refer to the :ref:`design +` for the list of all available operation sets and their +brief explanations. You can set and get what type of monitoring operations DAMON will use for the context by writing one of the keywords listed in ``avail_operations`` file and diff --git a/Documentation/mm/damon/design.rst b/Documentation/mm/damon/design.rst index 9f16c4e62e72..6abf976dd71f 100644 --- a/Documentation/mm/damon/design.rst +++ b/Documentation/mm/damon/design.rst @@ -31,6 +31,8 @@ DAMON subsystem is configured with three layers including interfaces for the user space, on top of the core layer. +.. _damon_design_configurable_operations_set: + Configurable Operations Set --------------------------- @@ -63,6 +65,8 @@ modules that built on top of the core layer using the API, which can be easily used by the user space end users. +.. _damon_operations_set: + Operations Set Layer ==================== @@ -71,8 +75,12 @@ The monitoring operations are defined in two parts: 1. Identification of the monitoring target address range for the address space. 2. Access check of specific address range in the target space. -DAMON currently provides the implementations of the operations for the physical -and virtual address spaces. Below two subsections describe how those work. +DAMON currently provides below three operation sets. Below two subsections +describe how those work. + + - vaddr: Monitor virtual address spaces of specific processes + - fvaddr: Monitor fixed virtual address ranges + - paddr: Monitor the physical address space of the system VMA-based Target Address Range Construction From patchwork Sat Feb 17 00:58:41 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 13561141 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 1B4A5C48260 for ; Sat, 17 Feb 2024 00:58:55 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id D4D9D6B008A; Fri, 16 Feb 2024 19:58:52 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id CD3B26B008C; Fri, 16 Feb 2024 19:58:52 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id BC4026B0092; Fri, 16 Feb 2024 19:58:52 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0010.hostedemail.com [216.40.44.10]) by kanga.kvack.org (Postfix) with ESMTP id AD1666B008A for ; Fri, 16 Feb 2024 19:58:52 -0500 (EST) Received: from smtpin24.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay08.hostedemail.com (Postfix) with ESMTP id 83BEE14011C for ; Sat, 17 Feb 2024 00:58:52 +0000 (UTC) X-FDA: 81799486104.24.7781AE1 Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by imf28.hostedemail.com (Postfix) with ESMTP id CFF17C0010 for ; Sat, 17 Feb 2024 00:58:50 +0000 (UTC) Authentication-Results: imf28.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=ISsyfP3Z; spf=pass (imf28.hostedemail.com: domain of sj@kernel.org designates 139.178.84.217 as permitted sender) smtp.mailfrom=sj@kernel.org; dmarc=pass (policy=none) header.from=kernel.org ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1708131530; a=rsa-sha256; cv=none; b=tIxOOEKOGUkKqpLbXlwgRRHJpx9HneZtXnRJCIPuV8V8Ehz486fqeMcBiqZFK9+PWtUB75 p9mow2T6ys/OJzD7Xw/YtE5hpX2y/sRChO2uKQF5HUnJDGV1mvGUp9cx5o7yjUsTjFPmCY 2JGbXkCFh68jgWsaAad4FrZ3SGM1HtA= ARC-Authentication-Results: i=1; imf28.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=ISsyfP3Z; spf=pass (imf28.hostedemail.com: domain of sj@kernel.org designates 139.178.84.217 as permitted sender) smtp.mailfrom=sj@kernel.org; dmarc=pass (policy=none) header.from=kernel.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1708131530; 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=8PWuhTpuCPgkgD8TID0mUqXK8MB9KE98oJma3+L3KHM=; b=1hgdsQxifiWlW2cRHkR5mpe+V/DRomvuQGah6uJqmiBtKhWwiq0rzLoaYOVaISmG7ojlao 8OLeMgkyq/oY15VcvbFXB8G3rG0Az/HCr+m44huka3sZqNAsTHDz63Kw5GZ7Yw3Hrl63pF kBX0XiW+frL03IPiXgodzRurueDKdDw= Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by dfw.source.kernel.org (Postfix) with ESMTP id DEBAD62112; Sat, 17 Feb 2024 00:58:49 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 00CB8C433F1; Sat, 17 Feb 2024 00:58:48 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1708131529; bh=6n2FATexNcLId4djVWKHF9wa5NUBH9cgNCITDt2Fr18=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=ISsyfP3ZrwLmaMw1RafF3JsD6d33RuEvcLcbAEmduwXDR9M2kuhUQTy9tz9cN7tTz NDeLa3meDWtsWp9y5+LB/9snyNbOChBxsbAKgTHiUQQyw4KeuVlYNhzGrX9uRpIS6x p/rhICMyyMBvQi+QYZMOESAHbv6fCQ+rQg1OwiPV4fneYCcCi6QM8vMhAeyCzBzCKR ekGrLzkmFRU6AekKPY9dToMotM6+gIEbLim4OOw7olVO397RqeIlqxXnMqOrc/iQtq ZG1CsALtnmtEPzB490JOvu11WJrILRoOW3W7aGazKv0zLOKUClugFBU3Ejeue9tFem Bf0eNvc+wkDuQ== 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/5] Docs/mm/damon: move monitoring target regions setup detail from the usage to the design document Date: Fri, 16 Feb 2024 16:58:41 -0800 Message-Id: <20240217005842.87348-5-sj@kernel.org> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20240217005842.87348-1-sj@kernel.org> References: <20240217005842.87348-1-sj@kernel.org> MIME-Version: 1.0 X-Rspamd-Server: rspam08 X-Rspamd-Queue-Id: CFF17C0010 X-Stat-Signature: 7sqb6fb48yb1my365qxpm4qdfxks7t6u X-Rspam-User: X-HE-Tag: 1708131530-125607 X-HE-Meta: U2FsdGVkX1+ydIOj5VhV9iTJjRrptmCBR863nxiDYrj5z3mnZLmpsDErBhP6aGVy+3pfxO6rIIHsjpLZwb0exjfQsnogyMa7i6UvCRCQdTE+7fCMVQEcSKaxrjXsxYdYX+EcJGsaHQsQecamLVZXqstddKATsp1A+V7gOTNS5I0OJKJiiA2uJBfGhVzc/mcc9bPPUasyaGj3wMVSrjIJRrHlCpQ+0DKhtIX/3XsWomx8iqW7x121KI0jNuihijmWRw+akOOqDaKntI4e7vf45YBaNOqDIPPw8VUDauGqwdOgpwQ8hpgH/OEuZAq4ahePNyee7EtQWcc1Cl/XxCb2nz7BXU2lBXvVSlHGfpt6PbgNfcoGxmzd9d2Ufani60BfoabMj51ewycygr/cyR04bQI6bwA0ORLGDFGdTvfYJN5Hf2mbfSDW3HsGHQHtMVr9gzYxQxMrtinp+Juc9Dn78G7a+63ShjopXOd+THBbs4CuF572mlRYrFrnHc78IZiJg1SCLumTy9vgeoSsD4Jx8C8/fTSFLJ61ApwVmYOBUeztZsgpSnBxMnnWEsNzJ9nXFyBF1771Jq69J2hSg1aDOSmMQtoj35z29jdmPQUJDEb5A+70kEoMYiivp0QeTSu+DOKcPHN1ZLulIgHS2KQ8h++8RY+do/GxeExizmaCRb4N76IvZuuo+6DK/ugOpHclpEl9NyZziyZCRAWjkthxfrlG9n8FufBHBRCOuZoN0/x6GsHV/u+FaDwmVqaBtw5CixN9bRNiBAL6fW+fYgPCeVhATnMueqIcApiNgdFkm761Aiou2QKDNnCfXWaymDviA5hw9S7qj4/BfxnE31OsUfrFixu2XH99EUQklndufwXEpu4flzNezBceFfGXcOn833pCsT4mQxb57wot/HWU3u3BBBygxdS2BDbKgMa2XDIcM9sfbZYJi3l+2IuURNEgYVTUDgwdUg4h4/Eo1NP cjGjQX9j BfvJp9NibpSc1XlSAoawHUuwU4BdXTcJeC7tLubVbhqf1Bb1Nz8X9ucDAwSCx+ZnIVkb0pPLKcOIdDbrZ2m/oxwrhK5Wr3K5QV2sQnJiLroh9YBJZPwkW3WX+bGxhHvhF3GJ/EBnrMwyCOAVeJOMYCtv2SBU9393YZ33hqliNwK2aKsnu2h2TtJMD5z5hQPZjTbWI2Wusf1kAz4hLvUfga6x/6X+OhTrmJVvZQu3iYNEazy5DRmlCcDq0nH/UQ0LY49S0BgrGh8SRPWA= 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: Design doc is aimed to have all concept level details, while the usage doc is focused on only how the features can be used. Some details about monitoring target regions construction is on the usage doc. Move the details about the monitoring target regions construction differences for DAMON operations set from the usage to the design doc. Signed-off-by: SeongJae Park --- Documentation/admin-guide/mm/damon/usage.rst | 16 +++++----------- Documentation/mm/damon/design.rst | 12 +++++++++--- 2 files changed, 14 insertions(+), 14 deletions(-) diff --git a/Documentation/admin-guide/mm/damon/usage.rst b/Documentation/admin-guide/mm/damon/usage.rst index be0924f47a42..fefe62e0a466 100644 --- a/Documentation/admin-guide/mm/damon/usage.rst +++ b/Documentation/admin-guide/mm/damon/usage.rst @@ -242,17 +242,11 @@ process to the ``pid_target`` file. targets//regions ------------------- -When ``vaddr`` monitoring operations set is being used (``vaddr`` is written to -the ``contexts//operations`` file), DAMON automatically sets and updates the -monitoring target regions so that entire memory mappings of target processes -can be covered. However, users could want to set the initial monitoring region -to specific address ranges. - -In contrast, DAMON do not automatically sets and updates the monitoring target -regions when ``fvaddr`` or ``paddr`` monitoring operations sets are being used -(``fvaddr`` or ``paddr`` have written to the ``contexts//operations``). -Therefore, users should set the monitoring target regions by themselves in the -cases. +In case of ``fvaddr`` or ``paddr`` monitoring operations sets, users are +required to set the monitoring target address ranges. In case of ``vaddr`` +operations set, it is not mandatory, but users can optionally set the initial +monitoring region to specific address ranges. Please refer to the :ref:`design +` for more details. For such cases, users can explicitly set the initial monitoring target regions as they want, by writing proper values to the files under this directory. diff --git a/Documentation/mm/damon/design.rst b/Documentation/mm/damon/design.rst index 6abf976dd71f..2bd0c203dcfb 100644 --- a/Documentation/mm/damon/design.rst +++ b/Documentation/mm/damon/design.rst @@ -83,12 +83,18 @@ describe how those work. - paddr: Monitor the physical address space of the system + .. _damon_design_vaddr_target_regions_construction: + VMA-based Target Address Range Construction ------------------------------------------- -This is only for the virtual address space monitoring operations -implementation. That for the physical address space simply asks users to -manually set the monitoring target address ranges. +A mechanism of ``vaddr`` DAMON operations set that automatically initializes +and updates the monitoring target address regions so that entire memory +mappings of the target processes can be covered. + +This mechanism is only for the ``vaddr`` operations set. In cases of +``fvaddr`` and ``paddr`` operation sets, users are asked to manually set the +monitoring target address ranges. Only small parts in the super-huge virtual address space of the processes are mapped to the physical memory and accessed. Thus, tracking the unmapped From patchwork Sat Feb 17 00:58:42 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 13561144 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 9FF08C48260 for ; Sat, 17 Feb 2024 00:59:03 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 168186B0093; Fri, 16 Feb 2024 19:58:56 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 1154E6B0098; Fri, 16 Feb 2024 19:58:56 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id EAB916B009B; Fri, 16 Feb 2024 19:58:55 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0014.hostedemail.com [216.40.44.14]) by kanga.kvack.org (Postfix) with ESMTP id CA7E26B0093 for ; Fri, 16 Feb 2024 19:58:55 -0500 (EST) Received: from smtpin13.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay04.hostedemail.com (Postfix) with ESMTP id AE33D1A012A for ; Sat, 17 Feb 2024 00:58:55 +0000 (UTC) X-FDA: 81799486230.13.2605AD5 Received: from sin.source.kernel.org (sin.source.kernel.org [145.40.73.55]) by imf13.hostedemail.com (Postfix) with ESMTP id B37C22000E for ; Sat, 17 Feb 2024 00:58:53 +0000 (UTC) Authentication-Results: imf13.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=K4bEzdFL; dmarc=pass (policy=none) header.from=kernel.org; spf=pass (imf13.hostedemail.com: domain of sj@kernel.org designates 145.40.73.55 as permitted sender) smtp.mailfrom=sj@kernel.org ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1708131534; a=rsa-sha256; cv=none; b=pySSVYOorc+3gt9FR0MM4qLQLUu4Lfk7Z+vWUSpE7L3EtQZjF5dST3AkAmD4DJvMOd23vG AnCdE1Xe9meRN+JAzQrbQ6Wj4O+kTAOPJQPBbUX1s2+Yp2r6LNY/76LMRLFXEcIHanz3R2 1klBDme9xBZI5EAS2JEnZ1/JGWGGklA= ARC-Authentication-Results: i=1; imf13.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=K4bEzdFL; dmarc=pass (policy=none) header.from=kernel.org; spf=pass (imf13.hostedemail.com: domain of sj@kernel.org designates 145.40.73.55 as permitted sender) smtp.mailfrom=sj@kernel.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1708131534; 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=YoHlLRZa70cDva0swQmietSnhunN8Y6JL240OM9dUhc=; b=OYbLY9GlBXY58kJKTTG+LYJENRxLkxxrEDfZuzDvGafBpk2otjrN6J7JWT+nHOssYYWVgc PMEBrgPqE5V+4C00UCGhByUayB+mDPnruRYa1DiYbmYERf2J9DxOl0Z/SVW9s8Fz7syHQM QApxOPCIFUnaCwOXw9DBrA/v1hTw3Kc= Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by sin.source.kernel.org (Postfix) with ESMTP id 18B35CE2DA5; Sat, 17 Feb 2024 00:58:51 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id B5D15C3277B; Sat, 17 Feb 2024 00:58:49 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1708131530; bh=zjtUmDw2W04Oqswzi7ugwTbYsUfBySmq7qQ57D2h3/g=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=K4bEzdFLDlF6NLqwGK/mAAgfMMKWdnJ8vklpKYAdUXCed+fMo4jl0CvKX/mU2OAFn arCqEtlWyJt5NSpJVt1S0W0F4hksykL5ZFvZ9d4n7IYMnUQy46xVjZ95hKG5qtazQ9 mqzObWI8j5FId7H/EaphvGBxODbmk1E3N9bOTqyw/OBjE81il5DUZ23VvjMN7QpFMZ UETBSwIEX9MS9V6yCtXvWn6r5ldcHWnQDixxgZ5jQ05micq0XxuvRz3M937Ftlb84H 4vrksfLUmh2xuqU/SyQmUsE1zjA404Sathszb2uCr6DW5kSIhXCXtRyCO9viVxCqjp gigOIuoHt+lPg== 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/5] Docs/admin-guide/mm/damon/usage: fix wrong quotas diabling condition Date: Fri, 16 Feb 2024 16:58:42 -0800 Message-Id: <20240217005842.87348-6-sj@kernel.org> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20240217005842.87348-1-sj@kernel.org> References: <20240217005842.87348-1-sj@kernel.org> MIME-Version: 1.0 X-Rspam-User: X-Rspamd-Server: rspam06 X-Rspamd-Queue-Id: B37C22000E X-Stat-Signature: 9qimxmfkdkqdwe5kmnhcemxbzzp4zjpt X-HE-Tag: 1708131533-288846 X-HE-Meta: U2FsdGVkX18OP3pG3ByUIczn99olD8+uP6eqzaaQvODlJTMa1ghLZqsNXn3bO3KSCSol5WWOmIUPHuP98A2IFn5aTzNlPEn6fdXn6zL/vIiBf+3Q95igiAN0R8evtjtxCO0EAEAXmJ5DouV1tXrelDCL3Y92pz0hWH3pXKOBBxNx00nQHZxdLvV3Qu3OKDlVKZhOZvd1LWLYrbynr4+6FTCQkvqDraiYLYZhB57eW5U+IV0H922I2ua6pIjBeHSh+NfbB/ZNEYivJbvAxXDbU6DmY+B83mfYEop7y/gq4m+S/3YvZAFtkbN3LMchc/g1xkLBYonBfCkCfygR/JcCceCu0Dk2oPAyCOycOHtA1S9YKziAM0w6zrObZISwBk4JDlZd+obafwk5FQA2tkWE7Vu3E5my6Mt19DGxmI0kI95ItBei+TOJlikMFJjDKYssKJn4sTyN8uqay2yEyzM2RPgmjvbUSBcZWzeXidl60BfXMPjwZKFHUCUpY7M59trZbhfSBkTYCTM6ncQDev8zgOjqKJlFaoK0WL0e5InpY7IRQkhjMCNRnm124KKtuls2/tJMnLGgCgYS6go0dvsICSKUeWqvBPFbdHqWe8yjR1eh90VzKFNaCzzKl062i7XxCeAWL9jjxM7AuofNi0u+PE3dRYRpzp5V+4iw2VL9HGtqEttzlrTY0GNAAftPmoK44uzwxiiUzUHJTbxf6Vmmee2pffFKsW0Y1u8DPn4u4NJAuf8yzl58kJ5/vdqVtqh9lM3i4xySOQiAFg0vJ7Mm7xtS+8bGt5PVsgsDaf9gcd5WknVs8ySKWcrvo9O8IFV4k5A7EDyUXZLjlEc5gxBfNvUS5EYjVpBA/DnpkqQV2T+JGXLIlaX00wX0lWxFaEj5Ntys5EJ3QVftX2AsHMrZcgYO/Z6d96yIf4sn4wLmhVAcqDWOObZixBDVCT92xJIX30ZxugND6wqlwiA9dCK y716YEW0 1uAwZPIyXmutvfVBOunCdBQhk7+GdBNN+/yoEJ1aSRVibfOYW6irfqeYiASZCwKfF8KCF7KptzgxYqKZQK8TG02r/GYs+9DD/0wTn6P4fk9A8oS+EoxMpfmQgiXs993yj9YUHmOnZzy3Wavxc38P37RWPpOwJF64BuSAiDqIgjWgCKjH4VvF24yiXxemqIv1HjLwo1azHIANe1TzMcivkL6QNE1S3LSJQPDNRkDRO0MUyo6c= 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: After the introduction of DAMOS quotas, DAMOS quotas is not disabled if both size and time quotas are zero but the quota goal is set. The new rule is also applied to DAMON sysfs interface, but the usage doc is not updated. Update it. Signed-off-by: SeongJae Park --- Documentation/admin-guide/mm/damon/usage.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/Documentation/admin-guide/mm/damon/usage.rst b/Documentation/admin-guide/mm/damon/usage.rst index fefe62e0a466..db6620b5bc0a 100644 --- a/Documentation/admin-guide/mm/damon/usage.rst +++ b/Documentation/admin-guide/mm/damon/usage.rst @@ -329,7 +329,8 @@ respectively. Then, DAMON tries to use only up to ``time quota`` milliseconds for applying the ``action`` to memory regions of the ``access_pattern``, and to apply the action to only up to ``bytes`` bytes of memory regions within the ``reset_interval_ms``. Setting both ``ms`` and ``bytes`` zero disables the -quota limits. +quota limits unless at least one :ref:`goal ` is +set. Under ``weights`` directory, three files (``sz_permil``, ``nr_accesses_permil``, and ``age_permil``) exist.