From patchwork Fri Apr 26 19:52:45 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 13645330 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 61DD4C4345F for ; Fri, 26 Apr 2024 19:53:18 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 335A96B009E; Fri, 26 Apr 2024 15:53:10 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 2BF386B009D; Fri, 26 Apr 2024 15:53:10 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 138ED6B009E; Fri, 26 Apr 2024 15:53:10 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0011.hostedemail.com [216.40.44.11]) by kanga.kvack.org (Postfix) with ESMTP id D82106B009B for ; Fri, 26 Apr 2024 15:53:09 -0400 (EDT) Received: from smtpin28.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay10.hostedemail.com (Postfix) with ESMTP id 8AD87C08D9 for ; Fri, 26 Apr 2024 19:53:09 +0000 (UTC) X-FDA: 82052731698.28.34E9A7E Received: from sin.source.kernel.org (sin.source.kernel.org [145.40.73.55]) by imf24.hostedemail.com (Postfix) with ESMTP id 4BE5218000E for ; Fri, 26 Apr 2024 19:53:06 +0000 (UTC) Authentication-Results: imf24.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=DSFNDYcZ; spf=pass (imf24.hostedemail.com: domain of sj@kernel.org designates 145.40.73.55 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=1714161188; 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=BM5nebvS4moKlSYBewH8Mgk00Cqm3ZMX+/8gbuFwpuo=; b=npvv6gFFjXPhjyDk6DvKOeLjUep5xFrxdsVx9wkxh9G7t8bpkyeHVo8SS2bHLvhIGcTw3R So0COiNzhZmK3JTDvpd8QJWcPXnjujXowQwTXjLEa8tIH1AFqRYX80RwOVruJ1n/pCBnl7 p/xzMbQZ4kqn+QEiZl8ak7mfrVMSIrA= ARC-Authentication-Results: i=1; imf24.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=DSFNDYcZ; spf=pass (imf24.hostedemail.com: domain of sj@kernel.org designates 145.40.73.55 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=1714161188; a=rsa-sha256; cv=none; b=o7iWq3gR3bO6AwN5YZP0cvYGv/DKzOeRtvi31VyZNUZt9Mug2AF14c8wkTMSlHDiFQ/K7a irgtHNvZOvwpspKmwgXD8RDaf06diDxXkTIm0sgO5paL5nlykVxKsViQc+LSuGeQN/0TVY NzIywVG8akvc7GdJFKNAPOG4vi51anA= Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by sin.source.kernel.org (Postfix) with ESMTP id AEA77CE1D15; Fri, 26 Apr 2024 19:53:04 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id C3142C2BD10; Fri, 26 Apr 2024 19:53:03 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1714161184; bh=K2q9FissW13tAkvxEMeW2S5JbkJ5qv3UfNIiwo/yV/I=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=DSFNDYcZ5ydHl9BLQEPGlilvTLW2NF0PHASHNaeYYzH/IQkb7TIhayU7DHFGXKWuq yDnjWbS6g5F/zwAj2dSG84H1DBt9ceqztSEcropReTs4M7kuxPV9TThRzeKu/JuD0U h2gjAkllDCJQSEr4OWpX16oU+h/cobOIqx/kvuZr/ZPvqRxLsdDz1TWq58Y1uSjTdB KG2/YRUz3XFQ2lUMj8D4sUDlvXOvo0ZwJYL+Zh8slDqm6FtGDbhgNPxTbZ/CqoMjY7 4C07ybL+Udwe/39rogZpBtUgPe9/Cefr/RZWfqMfcHwYR7QnGWrNRTLKkjCC5eUayp wgHoLmDGbo8Nw== 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 6/7] Docs/admin-guide/mm/damon/usage: update for young page type DAMOS filter Date: Fri, 26 Apr 2024 12:52:45 -0700 Message-Id: <20240426195247.100306-7-sj@kernel.org> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20240426195247.100306-1-sj@kernel.org> References: <20240426195247.100306-1-sj@kernel.org> MIME-Version: 1.0 X-Rspam-User: X-Rspamd-Queue-Id: 4BE5218000E X-Rspamd-Server: rspam06 X-Stat-Signature: 96frcom656py8d9zah9fsy3u4hf7ubqj X-HE-Tag: 1714161186-301840 X-HE-Meta: U2FsdGVkX19Y5e7xpkP8nTihjwqGgI8YYwrZYp8bAlvAdN2STu65AzdsBcoEv8vWW7Ry2zKmpcWfLHN6JVx5164+mxmltZr/VP11FMNnFEsdBzV0SlrSVIJTGRCZ1C4Fcy94X2k74gDmQEYTUl0z/0bbU2wy4uA2Sbwcjvk0tROrXpjfQF5WaD4+u5w2RQJRZZnINsfK7Hier6ej3GzoLAGATbQOJfGo3MXsXuuvJNRO+1ZVVz52Q71nYtw0827/x4gGrJJ5J2THz5hMW12+UWkesn2yKaW70p+YxSR5x43KZZ4U28cH70IIwl2W/NIfWmmIkcRnoF9xxN/frJcTt3xcsXjwVQdfy4A8cNjkU9llQz6zXeJM+futO+yd1HqzPxoagi/t8n6iZ9aWKq63b8D2Jv1Pke7Zn00SdgUfdpdX57qM5sWC7P/LfgzWffpizf2JDaedexclFB9fBEZgDH+YsH7wLwCD9Gsu4Yd74XcaZ0Kr4VxxfC6pQF82yNg8vmc0CLgPxqOsoy4CyV/HAUGJxfnQkTJZ1t1pYKAQzeAyAC/ig+G6lU9+MHq5GBs73lwxkT98KPfcD0ccpIEcSdDX1xDtshyHXs9nSG4fdF9LEROsQI16WUV4pXI+lZ81M/+quc8kl3kqomSXPVXB75qUDFKImNn8cnGehwmpb4jfRVP6UNiHGEOWsgFza2VSiBo8nHjh92tabCdgFcoQi7jpcsi2eMPM3Y9PALsNng7ayIvZvXU85UIYU2mMk4WBpXMacBGkrqAjG/Z6K/9gvRWnU/eQWpIQTy4LrvVjdU8Pg4sQ1mfBb4xWg//LJ8plBY7sXaOjL6x1pdXZSOStV8m9DskbAFClr8yavmtSMn0Hz4/8yvkdpQC3ptV1FA/U75bPAqQXmNHCWJp0xjFCFb4Xpm5oUjzjr9QR/D8FkphluXIrcRx+02UM7EcuI46irj6AB/wyyDaGiK3Wv48 OSc+D+sN ogg1EOHOaMe1PWCDUkNCtyRluckoxn4lIuP7328TlNY7fWpo7HMWv5cfOwOsTGiE7hb6a0ht2xDpLRuw6RhQ6BQk/VZgn0Czd/F35OB4BKlm57lUmVckA6U60ksUNNffM5dtjmIb/SgXnlUMA//GrjG5hiZp0kP0wH78A42u/qac96r6DNU5KFf2mykqcT1XcQep57bl6Hbq0pyjcgR0bsdUZRSmD9p7ajX6lSFqLD0fbIkE= 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: Update DAMON usage document for the newly added DAMOS filter type, 'young page'. Signed-off-by: SeongJae Park --- Documentation/admin-guide/mm/damon/usage.rst | 26 ++++++++++---------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/Documentation/admin-guide/mm/damon/usage.rst b/Documentation/admin-guide/mm/damon/usage.rst index 6fce035fdbf5c..69bc8fabf3781 100644 --- a/Documentation/admin-guide/mm/damon/usage.rst +++ b/Documentation/admin-guide/mm/damon/usage.rst @@ -410,19 +410,19 @@ in the numeric order. Each filter directory contains six files, namely ``type``, ``matcing``, ``memcg_path``, ``addr_start``, ``addr_end``, and ``target_idx``. To ``type`` -file, you can write one of four special keywords: ``anon`` for anonymous pages, -``memcg`` for specific memory cgroup, ``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. 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. +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. +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. For example, below restricts a DAMOS action to be applied to only non-anonymous pages of all memory cgroups except ``/having_care_already``.::