From mboxrd@z Thu Jan 1 00:00:00 1970 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 43075C282D3 for ; Tue, 4 Mar 2025 21:19:41 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 6387A6B009E; Tue, 4 Mar 2025 16:19:30 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 5C3076B009F; Tue, 4 Mar 2025 16:19:30 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 412396B00A0; Tue, 4 Mar 2025 16:19:30 -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 1ECEB6B009E for ; Tue, 4 Mar 2025 16:19:30 -0500 (EST) Received: from smtpin22.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay02.hostedemail.com (Postfix) with ESMTP id D1A7D12065B for ; Tue, 4 Mar 2025 21:19:29 +0000 (UTC) X-FDA: 83185134858.22.51ABA0A Received: from nyc.source.kernel.org (nyc.source.kernel.org [147.75.193.91]) by imf24.hostedemail.com (Postfix) with ESMTP id 05BBB18000E for ; Tue, 4 Mar 2025 21:19:27 +0000 (UTC) Authentication-Results: imf24.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=H+yFtLDF; spf=pass (imf24.hostedemail.com: domain of sj@kernel.org designates 147.75.193.91 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=1741123168; 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=eqxFwr1YF/5aKyOTrxEZTybI/ra9eSf1gDz823CD7H8=; b=SeYCO1Tmq2C4mOoSz7DOyvcN5u9an8mSplBz1MI4BStJE8iucVYaR6oETjYDa9Gu2FD2/A 673q/qcMq78I9ZwmQ4OsOD/H06x7YU47EkzqBMurq9Es+iAJcGty670+2s0wtA2OmwQLU5 5lXYIXniDW5P0a+tDFesehOPmsbp9os= ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1741123168; a=rsa-sha256; cv=none; b=QYp0m8Ko61HWkEV3ayyMjtTv036NqpSOTKQmCnUVGWknR78sj9WHMlUPcKNrvDt00ewfCo wuIl5kgUs6lOH1AHx8qdq4E+92Az1m4/XI2cfcdFtVZQpEkaDQOAUanw/lMdL6pCxAuzix QtNtrL5cP+MwU/uz2w2tAGdlgiCqHdE= ARC-Authentication-Results: i=1; imf24.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=H+yFtLDF; spf=pass (imf24.hostedemail.com: domain of sj@kernel.org designates 147.75.193.91 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 nyc.source.kernel.org (Postfix) with ESMTP id 92CF6A45FA9; Tue, 4 Mar 2025 21:13:56 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 1049CC4CEE5; Tue, 4 Mar 2025 21:19:27 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1741123167; bh=MvYdk6+CJs1x3c6be1UzpWng25V7d78Qpub9AKz7s0w=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=H+yFtLDFGNtuTNbyJUs+cxgvACAguJ1tXWM+lVJ7fZHcH3tKreNyIYL/74ILQnPBF LlTEEqtW0LpjlYbcTMRDaiB0S8R5VwCl0QAmj4+m4Z/cMKj7SnTTIZH0u0dGbq15km XK8ubi0/sZefriDo97HjeujAKsKrZA4rtUA6leE6Z7jQFr81uQtBYPxTRh9QM6VEcw DhPEPbOV8b4U43JYDC4igFQ6atTlB4hhQLvgcCwUjdYDOoZC7ifnG4fpihSm5GpHwY YejZz9hEeZTh1c0n966bcFw8g722XNw6Lg6sL9DBfHXMS2xhiBKamFd/HXqSdbxpZn +/ver5JBcmoZQ== From: SeongJae Park To: Andrew Morton Cc: SeongJae Park , Jonathan Corbet , damon@lists.linux.dev, kernel-team@meta.com, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-mm@kvack.org Subject: [PATCH 9/9] Docs/mm/damon/design: update for changed filter-default behavior Date: Tue, 4 Mar 2025 13:19:13 -0800 Message-Id: <20250304211913.53574-10-sj@kernel.org> X-Mailer: git-send-email 2.39.5 In-Reply-To: <20250304211913.53574-1-sj@kernel.org> References: <20250304211913.53574-1-sj@kernel.org> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Rspamd-Server: rspam02 X-Stat-Signature: irrkpg4twnepoqcz67rbbkd6mnus5h8b X-Rspamd-Queue-Id: 05BBB18000E X-Rspam-User: X-HE-Tag: 1741123167-660497 X-HE-Meta: U2FsdGVkX18errwJKzFRf0pQwDBgqfQk8za4AWtdVWqsmdQ++8Gs0CO4uLGNKGm9l5yQ/iywqf0T0HVI9UntLXxaf01Bkim0teg4nrbbKLVZ2PoT7K3XIazkzjeBSmA6zW0G9ZQaHsmmSW25qA4SgZlo3kfIpUZhYj0Ket51ZzCD+09owss/c3e6VDfGGJkUkhi6j4vEl48+zT5nXWt93RaZziXAqVlCXs6AZIwqa+bU7TKpNq5L9340CErv6yIWd2H2cb5wGrgLQKGY2VypA12/1uA2ww8q9wwjjLHL79KiopYpNtykILm5WoU3GP452Kd0sbbVnSZOrG50eWYXsJFOatJxAbRBP2fUkXwQGwLe7io1J5oF/3stivIOT9jOSAMRE1xoNVnRt857en5Il1uvh9dncWX4bvfdecMb1fKY7O/a2JYjqzzxirApMstaHu7YQlmXZGWFI09o0gAPy+lMY3zi6OkcHs8O9dr4TMMYi9n4Ns+Tq/swhv3KNQmwcocepm8aN2wkrTP23X4g/O1Zy6/XYvDY5K0+cipUk9yH6+BhOP9TIK36aYOG01zQWZo6VHazO2BXlvDaXZu31Iql63lziXXGgeqzD+D2Al2RRiHfMGQg5ZbujNuwcEET5ao6/UQDdchSievsgAeAoApOR4RAT+FqQKC+gvxLx3S7qi2wINlGXCMIwETa5tp7zVN/XdOVoma+eZlnvCMWW2j8+tZNtTfWrqHGc/29uPEYQWVnHrW8cpKMBs+cAjaExDomr9LKqaaLB/MskMuRRivn7npzg6nwvSwNXvPtiavSw97W39fA+Bf9sc6GmJiXoDE3TeJBW9LeKGlA2ri9qc8BtrDU6ny7/9NB+VGJTa9+2auA9fh/azqxewnflqKRhTbIyl3ML+OE6nhmVdz7eSVQ6RyvWA2V8D3FWPYHGeSym4kXm+hpstZ1UOn0cgk0fS8zFKE5F+rYal6QJeK vaN89WdR y8c72YFhetjkP7MXf0NUf6VskLWE9V4fKFCSr2ILwoNpsb+P5WGbgsWre8gyB67XMrYT/MVLUvki6rAm/zEOQB7hglWDBrfWn4Do8geir8nWUR5vzcCS8TRkLMWpAQ87269wkkdMsEsLGsmFeASC640QMNim0ECNO2dMc3UDUE7AGFuqprm6WKNXGlKLc6E6idz8rEakZLy7ZTiQeh1B87HgBR8DaeoLTFXUKbgjpg8IAaMc= 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 the design documentation for changed DAMOS filters default allowance behaviors. Signed-off-by: SeongJae Park --- Documentation/mm/damon/design.rst | 10 +++------- 1 file changed, 3 insertions(+), 7 deletions(-) diff --git a/Documentation/mm/damon/design.rst b/Documentation/mm/damon/design.rst index 26c9ab10daf7..0cf678d98b1b 100644 --- a/Documentation/mm/damon/design.rst +++ b/Documentation/mm/damon/design.rst @@ -631,9 +631,10 @@ When multiple filters are installed, the group of filters that handled by the core layer are evaluated first. After that, the group of filters that handled by the operations layer are evaluated. Filters in each of the groups are evaluated in the installed order. If a part of memory is matched to one of the -filter, next filters are ignored. If the memory passes through the filters +filter, next filters are ignored. If the part passes through the filters evaluation stage because it is not matched to any of the filters, applying the -scheme's action to it is allowed, same to the behavior when no filter exists. +scheme's action to it depends on the last filter's allowance type. If the last +filter was for allowing, the part of memory will be rejected, and vice versa. For example, let's assume 1) a filter for allowing anonymous pages and 2) another filter for rejecting young pages are installed in the order. If a page @@ -645,11 +646,6 @@ second reject-filter blocks it. If the page is neither anonymous nor young, the page will pass through the filters evaluation stage since there is no matching filter, and the action will be applied to the page. -Note that the action can equally be applied to memory that either explicitly -filter-allowed or filters evaluation stage passed. It means that installing -allow-filters at the end of the list makes no practical change but only -filters-checking overhead. - Below ``type`` of filters are currently supported. - Core layer handled -- 2.39.5