From patchwork Mon Jan 6 19:33:55 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 13927791 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 864FBE77199 for ; Mon, 6 Jan 2025 19:34:34 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 383396B00A9; Mon, 6 Jan 2025 14:34:22 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 2E59B6B00AA; Mon, 6 Jan 2025 14:34:22 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 139CE6B00AB; Mon, 6 Jan 2025 14:34:22 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0013.hostedemail.com [216.40.44.13]) by kanga.kvack.org (Postfix) with ESMTP id E53B46B00A9 for ; Mon, 6 Jan 2025 14:34:21 -0500 (EST) Received: from smtpin14.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay06.hostedemail.com (Postfix) with ESMTP id A4D39AE7F8 for ; Mon, 6 Jan 2025 19:34:21 +0000 (UTC) X-FDA: 82978028322.14.3FD7D37 Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by imf04.hostedemail.com (Postfix) with ESMTP id EC25A40002 for ; Mon, 6 Jan 2025 19:34:19 +0000 (UTC) Authentication-Results: imf04.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=sxC7kO10; spf=pass (imf04.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=1736192060; 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-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=A3se7PLXJCnWzFggBLeTs9MNVwVA8FKPjsAQ++/xeJk=; b=Oim/CX/6nw5GkDRZIMIb0u1S900zOyvvsDF7rCbbjLNmKlyL/F6s1zUYOfUVf5ao7FPsFy ylbXxRe7IBljxFGo3hCtjeTEpDZBVEq/5PovAXJMufe+K4BNwE1doKN1pJ2+ksggsE8w5F gBgUa+It9Ojy7QclNsFY13Z9X6482oA= ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1736192060; a=rsa-sha256; cv=none; b=Aa61E9QlB2NKaf7AxGMiPoFCPjccdSL3HJ/Of5mvgekL7ujeWyw9pTz61LR5grJmBC7VNo 2nKffwHAfr+rbpwQC5eDSjqCXoKwTSVdciwsMztOp5amQ/RF8mAGdBKHO96eVRPZkWesMa cJXZxSW7kCY0Vw1iwmj/tHywQaB57Fg= ARC-Authentication-Results: i=1; imf04.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=sxC7kO10; spf=pass (imf04.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 EA1D05C401D; Mon, 6 Jan 2025 19:33:37 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 9EBE4C4CED2; Mon, 6 Jan 2025 19:34:18 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1736192058; bh=/5ferqdIUHJtb9RUNwfrb+SM/R7GDkwn6D3djVY4NbA=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=sxC7kO109urARAN/IKaIe5KGU3QthanXoODO6MLv0hb+ybBedxofLTMJ8e1RvRgDf 5b94o5op7f+O+m8QwnMLLB9wYjuRNf+pmiQHyP/efPt/KnXwyqckrxNreR5NdWAVom by4llLLglMagZmsZeM+0kom2SmvHWhPaLRSf4W0/w1XsVy0vMXsi3a9AmWCNbu+Arf pBbMfHZCAVzNbNPnSEjUvrNKn77N2uUj/aPIFglFYrclCTN/dDoBo/b9WgCDHG/xOS 6tvHh5L+PQCqlLJSqeEgytkeUXS6izaTje5mnRoUkv4/pPp0phfO3Cao8sjduLbZpG Pc1G/Cu17M5yA== 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 10/16] Docs/admin-guide/mm/damon/usage: document sz_ops_filter_passed Date: Mon, 6 Jan 2025 11:33:55 -0800 Message-Id: <20250106193401.109161-11-sj@kernel.org> X-Mailer: git-send-email 2.39.5 In-Reply-To: <20250106193401.109161-1-sj@kernel.org> References: <20250106193401.109161-1-sj@kernel.org> MIME-Version: 1.0 X-Rspamd-Server: rspam10 X-Rspamd-Queue-Id: EC25A40002 X-Stat-Signature: snmxjzq4sf6qg7zd4mgyomi1cwjb4zr4 X-Rspam-User: X-HE-Tag: 1736192059-251823 X-HE-Meta: U2FsdGVkX1+8vwFRd31NK238EHu81xxfsCm01S5Di6FEfJ7t/LJLJTY6exFrLR0cPWfaVW5tiV9+NfbfQMF9HJ3WcRx12Wo6iMoMmRlkXiEGdt1n5a6xTbQZvmUBTd5o7V2611UvkdmSMn0lZnmKtoPZS2/MmJxlo3jQ+kqnScFkWEgovFya0iT3nalrZWYvtkdZ/qxyc83MWcSB7pTMbouE1NwiUuCJ6zEb8HWMz56QLcjgG5shhYMnUJHue67eh7EDA4malc49FQ7kiu/Zga06n7YJ5r5PtHzFx9DonYDu+unXzNuWhd9+1pgJe9tuUml/ohw1GPVZWKSvhl6Qy8dkq39FQpP/h74S9LiBdTvm99ygkley/r3+wfnwMHjt6jDCP0A22yWtE6cjnGS0xMGJW2qDEPmyfS59zbQZ+qed8c4pbIkGHbj7ylEFVgZUumVbqCHEhNiCJW5RIi2kbx4vSrOAS+knrWBJXw4XlT+6iOKy90zqmsJmF3hrMumzmFT+kfSCUjKPfVnOgEfoeroxW7EUK1FLpaPvYHZ4Gvc4g4JcE2QGh3njpbzkx8HNr2Op+XooKsFC+HRDIEH41AQyIO7vXgQwPYXLKAoyGqFO5vuoD7nFfxLh2p832rJ7YnPuMtuYmmsZbkkGd7zSXObXoLz+pYHQ9jYocn+aDZcfJxXqRlzGoVAvQ5hXCdPVU7S3+1pSa4cn5/BHhXko97FwWmhR8oZDU4YnlBt/gyAS/KoShhK7a4hRa79vP/pawxKxpjJLTb/p1pUytoCivM3OLeN3EFPokbPJD8eHs6RLzoAQw7DsYjPFfgD4DIVU0N9F9XPHCKvCPYPwVYTUMn/Pa3DRhp7s8FzXJPqRdKNvoc00cxXrilYQ793E6ToDfaGjtkNNznnf1lHErCGnSPV3ALGZqdrmB+xGIu2ABEkHpYHQsaQPQ2fd1I25xrwTPFTehp9h+M/JVItTrtX fTGktuME mGngKDdrxJ3pWuwW4WDjsfooZnDNMhkYKoFBjRDGl+PHjB2C+I71U8qdXjuUPhX0pYh5gaDBoJayocsZTvhsxqo37jS7mfyBmuqXUsvuWVkwISb7lJq6duUnK7LuaiyAfHqA1/POcoHkwvZPXBwgxWkS6IitLsuUJy/eYGSIxlxb40i9Y+IO9KQ5iaUqpLj6Nk1pr85+AvyfRHuMy09KuyMqZJL09eri6der5SQJrlt9LqG+8D7ss+ApUY4LDsn70Siein5YXrrsamqyUBcsUPSuZehrON70NwG2sVj69bL/EedrdmEzR5X1k4aZS7IBzrEL+jq8IJPEAppc/HI2aull9+qCxNg01e5Ua 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: Document the new per-scheme operations set layer-handled DAMOS filters passed bytes statistic file on DAMON sysfs interface usage document. Signed-off-by: SeongJae Park --- Documentation/admin-guide/mm/damon/usage.rst | 20 +++++++++----------- 1 file changed, 9 insertions(+), 11 deletions(-) diff --git a/Documentation/admin-guide/mm/damon/usage.rst b/Documentation/admin-guide/mm/damon/usage.rst index 2e835c9bcfdf..95c174be9c06 100644 --- a/Documentation/admin-guide/mm/damon/usage.rst +++ b/Documentation/admin-guide/mm/damon/usage.rst @@ -84,7 +84,7 @@ comma (","). │ │ │ │ │ │ │ :ref:`watermarks `/metric,interval_us,high,mid,low │ │ │ │ │ │ │ :ref:`filters `/nr_filters │ │ │ │ │ │ │ │ 0/type,matching,memcg_id - │ │ │ │ │ │ │ :ref:`stats `/nr_tried,sz_tried,nr_applied,sz_applied,qt_exceeds + │ │ │ │ │ │ │ :ref:`stats `/nr_tried,sz_tried,nr_applied,sz_applied,sz_ops_filter_passed,qt_exceeds │ │ │ │ │ │ │ :ref:`tried_regions `/total_bytes │ │ │ │ │ │ │ │ 0/start,end,nr_accesses,age │ │ │ │ │ │ │ │ ... @@ -448,18 +448,16 @@ difference is applied to :ref:`stats ` and schemes//stats/ ------------------ -DAMON counts the total number and bytes of regions that each scheme is tried to -be applied, the two numbers for the regions that each scheme is successfully -applied, and the total number of the quota limit exceeds. This statistics can -be used for online analysis or tuning of the schemes. Refer to :ref:`design -doc ` for more details about the stats. +DAMON counts statistics for each scheme. This statistics can be used for +online analysis or tuning of the schemes. Refer to :ref:`design doc +` for more details about the stats. The statistics can be retrieved by reading the files under ``stats`` directory -(``nr_tried``, ``sz_tried``, ``nr_applied``, ``sz_applied``, and -``qt_exceeds``), respectively. The files are not updated in real time, so you -should ask DAMON sysfs interface to update the content of the files for the -stats by writing a special keyword, ``update_schemes_stats`` to the relevant -``kdamonds//state`` file. +(``nr_tried``, ``sz_tried``, ``nr_applied``, ``sz_applied``, +``sz_ops_filter_passed``, and ``qt_exceeds``), respectively. The files are not +updated in real time, so you should ask DAMON sysfs interface to update the +content of the files for the stats by writing a special keyword, +``update_schemes_stats`` to the relevant ``kdamonds//state`` file. .. _sysfs_schemes_tried_regions: