From patchwork Thu Dec 26 22:14:43 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 13921484 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 3F740E7718E for ; Thu, 26 Dec 2024 22:15:20 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 9DD3D6B0098; Thu, 26 Dec 2024 17:15:10 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 878766B0099; Thu, 26 Dec 2024 17:15:10 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 6F1DC6B009A; Thu, 26 Dec 2024 17:15:10 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0012.hostedemail.com [216.40.44.12]) by kanga.kvack.org (Postfix) with ESMTP id 43FF46B0098 for ; Thu, 26 Dec 2024 17:15:10 -0500 (EST) Received: from smtpin17.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay10.hostedemail.com (Postfix) with ESMTP id 00B06C1244 for ; Thu, 26 Dec 2024 22:15:09 +0000 (UTC) X-FDA: 82938513798.17.62E402D Received: from nyc.source.kernel.org (nyc.source.kernel.org [147.75.193.91]) by imf02.hostedemail.com (Postfix) with ESMTP id 924ED80006 for ; Thu, 26 Dec 2024 22:13:47 +0000 (UTC) Authentication-Results: imf02.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=XPjBLf78; dmarc=pass (policy=quarantine) header.from=kernel.org; spf=pass (imf02.hostedemail.com: domain of sj@kernel.org designates 147.75.193.91 as permitted sender) smtp.mailfrom=sj@kernel.org ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1735251288; a=rsa-sha256; cv=none; b=sQnxUoEW6M/geC+J4cq7NF9RO7OM8/Rchq2MkrYLVz+tNuMNm2F+mI+hXF5YwNfokM78GR vofvm7mnVpyISHaR3FBAKN0BH6JWALbDwNP7OinmhKeXTKVN1Su3GyW7o7pbf3R326PBRb 2MVrS1c+SWAZDDdIPRQES5P7ynh3dBU= ARC-Authentication-Results: i=1; imf02.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=XPjBLf78; dmarc=pass (policy=quarantine) header.from=kernel.org; spf=pass (imf02.hostedemail.com: domain of sj@kernel.org designates 147.75.193.91 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=1735251288; 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=JJ06T9O9U24aN5XM8EoaxdrXSk67OuwjY67lLlEgiBA=; b=K0Ushs1ZU40hVIqGL12SVaZrXqoOUSQCVbdyPHXVM+/twLYWWnMuN2k6ty8rxn9EkOeuBd Wmil2/JSFKXE8zpGxFhok91Gq1xqSTwATQrzi60pjueWoJZf49qj3MkBOgoy9KuzxGHQi6 fpbuTTS3/BU1KDuAOeFEGvY71IiItCw= Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by nyc.source.kernel.org (Postfix) with ESMTP id 09A2FA40F09; Thu, 26 Dec 2024 22:13:18 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 606DAC4CED7; Thu, 26 Dec 2024 22:15:07 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1735251307; bh=juadYvUhIrNs11RvqR4w499ufNXf6y5+YZmNZP0gQvA=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=XPjBLf782yiUQxV2UcpxQo/O1rKLu/pFbXb6x9/ZcwmcuKgjOG7I6FXRA0xZk4Ybj kKG+IjAweuFkwEF5Z6HZ0LVqUIoLMimFNaifeydwejNdTM8QTXSbic+d+l8J2LzYLI hjudt0QdHdzdDnUebPTTI5M2T1wZvKXQaxgrz1TbyXHRla/A240QKzG9rjG/+u/1xW veiSb2ae+BsAf6V5tJsYWbcZbwioj3pxZWvKLLKPCviv72FYPML2noi9I6ol4jTc52 cZx+4iTwcjn7UxHNRDK0ZzlI+Ke2jTodLo2g0YX8Ux5qoX8hxJtFTtQfjAvBPCv4Fx gfm8JGYr87gnQ== From: SeongJae Park To: Cc: SeongJae Park , damon@lists.linux.dev, kernel-team@meta.com, linux-kernel@vger.kernel.org, linux-mm@kvack.org Subject: [RFC PATCH 08/10] Docs/ABI/damon: document DAMOS filter pass sysfs file Date: Thu, 26 Dec 2024 14:14:43 -0800 Message-Id: <20241226221445.78433-9-sj@kernel.org> X-Mailer: git-send-email 2.39.5 In-Reply-To: <20241226221445.78433-1-sj@kernel.org> References: <20241226221445.78433-1-sj@kernel.org> MIME-Version: 1.0 X-Rspam-User: X-Rspamd-Server: rspam03 X-Rspamd-Queue-Id: 924ED80006 X-Stat-Signature: mmyy9yjs1temj3hztf94hwcqisaxfnif X-HE-Tag: 1735251227-931755 X-HE-Meta: U2FsdGVkX18RCT9R5+g/L9owLMb9rrmXZK01sQdl+KAgYQke2r4lxFmEMsq3USJ6VnneoC25Wb5srI+cxCULlfL+64TYMGJe/PEuI/9RTDG6Lqw+heZYsdMHKhXFa7gH3pfhvV0cPsGw+pYXsI0z+wR6KWJIhgwr57gjmYTcZaZfdfRHnxACY3tI4Wqk0cAG5+IORnYJo4BirLwoRkWE5JvzR6PpsILZVujREtEZnuW17Wlsu3pVgHhB2skUCBFZdpizRil/sZ/hAwY6suKkZPdAhHaqPw6DcRIHLQOjpFy+vuRLL1Mug/lYsWWgBq6BP98W9WauoAZOKhBYI5tRdJ3hl9H8CJpMen83YHhKWy+1cpu6zFJtrzQrROL+RoMa8n6tS16fgjrCupk1Xv7UAmxi91fyDRuXziL47WuaYIZ3ygu0PP8CBDxAmP5kUft5K0Tp/K7oo/6q+DUFsLmqV1nIob4vQLsMoEtetaz4fRYl5x5lLLtEr/z/Igh3B+rKmACPvybSQdxXHxNjVi2akGrZugDueRVFnIfWe2/wbni5Ftb97rms1PW4E/6SbaGN/mCy2l083yufD76p7nnKXF4yNq7YBB+Maq+JofuaLejafx5IMN7bNyCgtw0A4jkVp7CrP5/pvKgwejolLkafhMONc8lpaWdVLjs+JHzMJJVNpx+mQ2rrIJdrsg3JrRSG1deIQoJQxjeWcdeLqQllixWbwQUxsIwLwxi3vn/mrtIOsneRTQTc5VqVGih1Ha4AOMbN4aD+Wjj1tn4Dl0C5iafYRgyistRs+S6yi1xPPMH9U4WsZ9JjdarDkv+9dSnCiw6wOwGXRrMEOMyeJJfDtf8NrVxfBa1A/FbqFNkLBA7aZUeyObVKu+tiTUrFvi+bJhjx6LMUvT+5xHtO1tf77Kt77PcmzIkKZ7zGg6EzczdkewLd74iilka8wAzc3LxXEg9SmGJvBlJiMGPoWxs /VEP9+UT p2wywC72lfz+eoTWhwNgt8OlzafNJjB0tZDjCBaWkf6blgQ0JwZ3FqYzxLazroT0A2gulB70zdc8+wGaWUcNVZsV+pErrZOtJB2ZsRpTk5XHXxWuz8g87vvdAzi2o24qMzFiWq0sky9f9GVNl29wBs+Mxx+gcULh0++0/Fu/pbSdoar5q8zMKucQYr7p0qq3BnhZNScPglCy18eLguE8Sl598oYJAt+phgYVSmOQkhPawmHtI9F86izA38Hix1VcOdpf+yIvwZG70c48= 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 ABI document for added DAMOS filter 'pass' file. Signed-off-by: SeongJae Park --- Documentation/ABI/testing/sysfs-kernel-mm-damon | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/Documentation/ABI/testing/sysfs-kernel-mm-damon b/Documentation/ABI/testing/sysfs-kernel-mm-damon index 8c0acb31638b..688bd27d8602 100644 --- a/Documentation/ABI/testing/sysfs-kernel-mm-damon +++ b/Documentation/ABI/testing/sysfs-kernel-mm-damon @@ -355,10 +355,16 @@ Description: If 'target' is written to the 'type' file, writing to or What: /sys/kernel/mm/damon/admin/kdamonds//contexts//schemes//filters//matching Date: Dec 2022 Contact: SeongJae Park -Description: Writing 'Y' or 'N' to this file sets whether to filter out - pages that do or do not match to the 'type' and 'memcg_path', - respectively. Filter out means the action of the scheme will - not be applied to. +Description: Writing 'Y' or 'N' to this file sets whether the filter is for + the memory of the 'type', or all except the 'type'. + +What: /sys/kernel/mm/damon/admin/kdamonds//contexts//schemes//filters//pass +Date: Dec 2024 +Contact: SeongJae Park +Description: Writing 'Y' or 'N' to this file sets whether to allow (pass + through the filter) or deny (be blocked by the filter) applying + the scheme's action to the memory that satisfies the 'type' and + the 'matching' of the directory. What: /sys/kernel/mm/damon/admin/kdamonds//contexts//schemes//stats/nr_tried Date: Mar 2022