From patchwork Thu Jan 9 17:51:25 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 13933078 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 ABCFBE77197 for ; Thu, 9 Jan 2025 17:52:03 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 660176B00BA; Thu, 9 Jan 2025 12:51:50 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 60E1C6B00BC; Thu, 9 Jan 2025 12:51:50 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 414116B00BD; Thu, 9 Jan 2025 12:51:50 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0017.hostedemail.com [216.40.44.17]) by kanga.kvack.org (Postfix) with ESMTP id D56C16B00BA for ; Thu, 9 Jan 2025 12:51:49 -0500 (EST) Received: from smtpin18.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay07.hostedemail.com (Postfix) with ESMTP id 835BE16031B for ; Thu, 9 Jan 2025 17:51:49 +0000 (UTC) X-FDA: 82988656338.18.B39B928 Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by imf10.hostedemail.com (Postfix) with ESMTP id D89F1C0005 for ; Thu, 9 Jan 2025 17:51:47 +0000 (UTC) Authentication-Results: imf10.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=rKs0gZ2C; spf=pass (imf10.hostedemail.com: domain of sj@kernel.org designates 139.178.84.217 as permitted sender) smtp.mailfrom=sj@kernel.org; dmarc=pass (policy=quarantine) header.from=kernel.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1736445108; 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=cJ0bsAZLGHO/ui9QK+muosvWX50TfLnI6ItwdWh/3g4=; b=JfiU/YIUSBEj4LGvmwzrG2OLCPwjiglw3zCoOSpUQFCduqULjAQS47VLS2KO7oIaIIe4tf j7U2UEYBqG4lHsgR1ix1h62xz8Sbg/0pm3+VQpGyjCkQiy9R7/T8ogNKRz50YZO54sja4o 44vWDEdflStz5VMGdQPp6FwMclgztW8= ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1736445108; a=rsa-sha256; cv=none; b=JG+OlrHW1WFAlXpXI6yR0nvzyLt4E6f281wNgvpjrw3ta8CFLNh6kGXjVV0ib28NusSFsz ZaOIvletfktJpFp7QD16/C7zCO9QfXeN5coMTL893gno9zTjRHuWrqizzhV8ld8nDghFhX 73txC50F9ixYPoPtArj4teCPEV1VhBU= ARC-Authentication-Results: i=1; imf10.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=rKs0gZ2C; spf=pass (imf10.hostedemail.com: domain of sj@kernel.org designates 139.178.84.217 as permitted sender) smtp.mailfrom=sj@kernel.org; dmarc=pass (policy=quarantine) header.from=kernel.org Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by dfw.source.kernel.org (Postfix) with ESMTP id 2AFD25C5CB5; Thu, 9 Jan 2025 17:51:06 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id AE997C4CEE2; Thu, 9 Jan 2025 17:51:46 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1736445106; bh=jufb0sHL1L5krYu5xZ9uPN7YQ+OC0Evk60XYWVCJy7g=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=rKs0gZ2C2Zr7ye0+OdvYEFCw7MIAwCeZdC2N8tWy4GVn4gqpSrTU7VrYj3WjuFhqO 5ce6wlNJZQyAnYW+nf/hOeQ12qJSEqq4eQQ3TxdqiC0BPTSk9lmpbUp8mYYZSaCHya 79gYNA9ADpr5cESKx22cDAD26PJlLwu+4wXbFrCEcXojhxA6X3v4iYwjFb9phohury /nY9pAi0O/WhTiCg/NljqXn1nn0h/QqpvhQg8+hAkklGxF6sz2kUpNxBSWCRBarehj gkKw4cmmJNz3NIXzTIpQkZxgX+5QfAf8wPXiPC5YlZ+hPAeq+5QySqn587rIl5lnwY NaMsiIiHl+eQA== From: SeongJae Park To: Andrew Morton Cc: SeongJae Park , Jonathan Corbet , damon@lists.linux.dev, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-mm@kvack.org Subject: [PATCH v2 09/10] Docs/admin-guide/mm/damon/usage: omit DAMOS filter details in favor of design doc Date: Thu, 9 Jan 2025 09:51:25 -0800 Message-Id: <20250109175126.57878-10-sj@kernel.org> X-Mailer: git-send-email 2.39.5 In-Reply-To: <20250109175126.57878-1-sj@kernel.org> References: <20250109175126.57878-1-sj@kernel.org> MIME-Version: 1.0 X-Rspamd-Server: rspam10 X-Rspamd-Queue-Id: D89F1C0005 X-Stat-Signature: 6dpd5dnga95c1uu3dq7zqwq16gpwtk3s X-Rspam-User: X-HE-Tag: 1736445107-975762 X-HE-Meta: U2FsdGVkX1+i0qLoeWtGtPCmAqMmkxfI0II5hSkfpKBt8QQ0PBIPjRLFqHqoOdcnchy0DbAOu0gHj41yQSzpdNZQOiQJuma03AR2lM0rpJLQYbiZkF+/fkIyZs8nlh0M32h80kGZRyP5rOTwwL3AXGnRtvZxPh9gl9YgdZAgojIz7mpGzyARioe66Qskrzp2ym0WqvRj+3N8OBMF51r12T/A4BMQ06pcjTU6NnDCeFDt3MPSk9wANNVo2tRylUL0wHM8MytuiUp/+QLXnsSFRLRyB98p1QEl5DAUahbC2wnQUNVhipYnX/V88tuVNX9vtyLZitQDB+pyw4lkw1K89CPhZLjmRfv8vDg8coQQhdyqmsK+K/8xRGUNeosCXyjMxj76kmgIZvvCzgXrfj2T2a1/4tyzYXTjorQd3zyo8PnhG0Nq111NhM3Aqkr/aFHLHeFvLggX1+ZrBM2oiSSiHITVBkC65O91oCEGva9bq5jlbsmByM0wWIDjhLaCtJfWIzKtq1mqByVtjPxD+aAFwEvs1Dk8GVubrp4yppvHscO9zuSQbm5k9MkkJw6+3rvyJ3E8ZEs7x3f+d77JvI3n8MCgcjsZqy8scyGDg3Ka7NVyD6gOJoR13kBHucl3P5XXpXE5aGn/14srHrRHWOkVijh6rdor4ftds5ILnNxL2nz21/3vne0h607Fyr6UrtuAcsbx5lw5pK2ttGq32kUrWmP0qU9ooXllixVP9ILzPzn2NOzqrR31uM93xIBGtx4z89KhvZSt+A5jXjflJZVik/015chdOYB6N5KPqdhXNXh1/M8HtM1foLoZTMi6g+NL6tY/GsgobBF/kzDr64to1QXPPvaEtfLLGPD+PquIX1xj3XELlEKfPsePRqO7iHQPSX7SVpUDA0Gq4NzsJieuxWKYoN/QBZMb2dwmhbs2g7YDokwIQHv3mpBhjHPR5YdD4Ej8FN14BFD8bjDLjNP DJhF7Z2C EQommv7bTUXJvs4dOdZyBWXfJkxtCfi3YFmp6TiNtasqIMkVsarw7jzxQPRZLBXJ27iwEnbdHnVBuXhSnRxUcFs97UsnIfHYxxPexV1bP9KZJqf8wx01CKQwkVRPUTBtYeSaMbqJvhyDN3TW3SPmbga/XXDAobXVfZSLtOHwoyhKgh3OIQtUxFYMWrLN+wGVeQerCmAIH5Xu9iSAlx0PxiJj3Nqob8UUO6O2mShDZxcs7rVxLPYV2e7X+JaTdfEjqHCEwvao7sfSzHE7dj3kfQphYEdR7sQoJA/qYW7tqv5/0fRq7U2Xlmf2PG1JK3wS77S+op8JnM1lFlIcTsSWmY2EoHN0X5hJdWrxL X-Bogosity: Ham, tests=bogofilter, spamicity=0.000000, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: List-Subscribe: List-Unsubscribe: DAMON usage document is describing some details about DAMOS filters, which are also documented on the design doc. Deduplicate the details in favor of the design doc. Signed-off-by: SeongJae Park --- Documentation/admin-guide/mm/damon/usage.rst | 29 ++++++++++---------- 1 file changed, 14 insertions(+), 15 deletions(-) diff --git a/Documentation/admin-guide/mm/damon/usage.rst b/Documentation/admin-guide/mm/damon/usage.rst index 71cf29ae8502..8df3357dcfa3 100644 --- a/Documentation/admin-guide/mm/damon/usage.rst +++ b/Documentation/admin-guide/mm/damon/usage.rst @@ -411,13 +411,17 @@ Each filter directory contains six files, namely ``type``, ``matcing``, file, you can write one of five special keywords: ``anon`` for anonymous pages, ``memcg`` for specific memory cgroup, ``young`` for young pages, ``addr`` for specific address range (an open-ended interval), or ``target`` for specific -DAMON monitoring target filtering. In case of the memory cgroup filtering, you -can specify the memory cgroup of the interest by writing the path of the memory -cgroup from the cgroups mount point to ``memcg_path`` file. In case of the -address range filtering, you can specify the start and end address of the range -to ``addr_start`` and ``addr_end`` files, respectively. For the DAMON -monitoring target filtering, you can specify the index of the target between -the list of the DAMON context's monitoring targets list to ``target_idx`` file. +DAMON monitoring target filtering. Meaning of the types are same to the +description on the :ref:`design doc `. + +In case of the memory cgroup filtering, you can specify the memory cgroup of +the interest by writing the path of the memory cgroup from the cgroups mount +point to ``memcg_path`` file. In case of the address range filtering, you can +specify the start and end address of the range to ``addr_start`` and +``addr_end`` files, respectively. For the DAMON monitoring target filtering, +you can specify the index of the target between the list of the DAMON context's +monitoring targets list to ``target_idx`` file. + You can write ``Y`` or ``N`` to ``matching`` file to filter out pages that does or does not match to the type, respectively. Then, the scheme's action will not be applied to the pages that specified to be filtered out. @@ -434,14 +438,9 @@ pages of all memory cgroups except ``/having_care_already``.:: echo /having_care_already > 1/memcg_path echo Y > 1/matching -Note that ``anon`` and ``memcg`` filters are currently supported only when -``paddr`` :ref:`implementation ` is being used. - -Also, memory regions that are filtered out by ``addr`` or ``target`` filters -are not counted as the scheme has tried to those, while regions that filtered -out by other type filters are counted as the scheme has tried to. The -difference is applied to :ref:`stats ` and -:ref:`tried regions `. +Refer to the :ref:`DAMOS filters design documentation +` for more details including when each of the +filters are supported and differences on stats. .. _sysfs_schemes_stats: