From patchwork Thu Dec 19 04:03:26 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 13914458 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 293F8E7718A for ; Thu, 19 Dec 2024 04:04:25 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 9CB6F6B00A5; Wed, 18 Dec 2024 23:04:01 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 97A076B00A6; Wed, 18 Dec 2024 23:04:01 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 817286B00A7; Wed, 18 Dec 2024 23:04:01 -0500 (EST) 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 5E4926B00A5 for ; Wed, 18 Dec 2024 23:04:01 -0500 (EST) Received: from smtpin11.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay01.hostedemail.com (Postfix) with ESMTP id 2C42D1C83F3 for ; Thu, 19 Dec 2024 04:04:01 +0000 (UTC) X-FDA: 82910364810.11.5CC254E Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by imf21.hostedemail.com (Postfix) with ESMTP id 5906A1C0019 for ; Thu, 19 Dec 2024 04:02:57 +0000 (UTC) Authentication-Results: imf21.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=tEFCee2b; dmarc=pass (policy=quarantine) header.from=kernel.org; spf=pass (imf21.hostedemail.com: domain of sj@kernel.org designates 139.178.84.217 as permitted sender) smtp.mailfrom=sj@kernel.org ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1734581024; a=rsa-sha256; cv=none; b=cfGXpeDv2TZQ9h2kATiNMXExxOAu98I3xRyRKAuB+KgVAJHkVYQ7QsH1TWZwCqJ1Wobsth vNq/zraJzST/PKE6lEcmVN6d6uoxPJQ9CFYZfs9+z40kjMHAIbqgnvBQwYa4tUUA/UFno/ rl5xEVi/fkGXNrPx5aUNAnv0QokZXzU= ARC-Authentication-Results: i=1; imf21.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=tEFCee2b; dmarc=pass (policy=quarantine) header.from=kernel.org; spf=pass (imf21.hostedemail.com: domain of sj@kernel.org designates 139.178.84.217 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=1734581024; 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=J5RSSWXzP8dqb+n8valbxerEuRc0ZfJo6cDrPOu7DNM=; b=ITvNJ3qhF5gk/1BvYy6FTUK9hyf2MuDuUvuUBYcNqzSojxl0SPPxNRIYxRDe9QtLleGSxU 5HKejcNuIN+pN/HMdQnBugVKtDUlV/gEVdSNC8SEBkVBXQyO2Pgo/Uam/y3ryQusgiSDxW jJN20VWkcNsWSjhIjfx5H9OBDzts+Gg= Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by dfw.source.kernel.org (Postfix) with ESMTP id BCEE45C6627; Thu, 19 Dec 2024 04:03:16 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 39983C4CED6; Thu, 19 Dec 2024 04:03:58 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1734581038; bh=h5r/y4q9OO288YZFlZV7V3CQiTTX7mBJ1xQ9QZ3zXD0=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=tEFCee2bmSQtQ9UaGk1XPKYTROA/k1oiKvsqBrXetaeL9jreOXIZlDthVtyNK0w6c QTITd37deEBoPOY8rnjNAMMzSBeAWlyBG4HYLyL1SkvRmk3NXHGDoYnQpwH0Wcso03 NR7zGEGK8Ki1cWIuqOilbajHjbrnuc0ToyKh0aX8S+AkqiiErZDO+cYHxYzkNXohkO TMpZXT+pUp1u4Y33yM44o6NPzGnmjB/MsOql//UzofnTPvF0qz3C6Izsidxq2ukucH vbRvVhcePmcwnQnFSbQsQUCyszB1kiMpBlfQPBiri4PbsCDalpVjkjfDyswWc4Fo1L iHSkkL0K7yX3w== From: SeongJae Park To: Cc: kernel-team@meta.com, SeongJae Park , damon@lists.linux.dev, linux-mm@kvack.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [RFC PATCH 17/18] Docs/admin-guide/mm/damon/usage: document sz_filtered_out of scheme tried region directories Date: Wed, 18 Dec 2024 20:03:26 -0800 Message-Id: <20241219040327.61902-18-sj@kernel.org> X-Mailer: git-send-email 2.39.5 In-Reply-To: <20241219040327.61902-1-sj@kernel.org> References: <20241219040327.61902-1-sj@kernel.org> MIME-Version: 1.0 X-Rspam-User: X-Rspamd-Server: rspam03 X-Rspamd-Queue-Id: 5906A1C0019 X-Stat-Signature: r958se49k5wot6joa1zhrh5541js1m1g X-HE-Tag: 1734580977-580272 X-HE-Meta: U2FsdGVkX188r7teZ3wMthap5uHluGrlqS3NTblcYYutFecjr4P7aX2MKVO5nbk4J3LV4KAN68OeXRkclWawpEUihB7vWv1d54O3JyD4+z8XtiH/Uu/eH24f8h/5kvdDy+m9T65gTzaHKhkHMQcku/JwLAyr8ckjhw3z33qHdNliQ4nu5mMc69/5Fn8vNb4grACUAd/kAObZATdHB4ee4LmIjexQyrqU3QzOinInHIbxmNmdd5nOqn9q8zqj1Rvd71egSAna9BApolZQH7BcohPKBv/cGWGf9otd7wn0zRVuur9gh+wwZud5MA/20DV/507xzvWAbzKuRN295OIyB/77vquVI95XRwL/9d2dhRgssKqcINfZzlIvQfsSS4Z6SFpI1/QTNGH2UQBzFPbEmGTiCnfnTZKPtNRIKm6hCn02gUVfQVW4Q9T5bGZoU78vpQp1zR+IKNR91lOgcbrIWcsatVnnZtOVDEeXoSDNe6oDwQtwEl3WvdwXprZaWbIZM2+YzagAy6TxqtjGvSrnVJsH2MEqByI+9nxGKgGM550qOdBT6BIIqTEfh/7hEPzhPGowCyhthpvto3qx4Tcm94tJtlM0/AzHwW05W/f8DVzSTM1nIQmP6XD3AxR9YlzzRYXEyKxW7rIHQjki76UtOZpeZehCXl21YeHjD7p/fzhR2lBedVAD+F40Bxda+ASgLkcY4KY81E2O3vaNDuV4YjYfDmoEn8XI1zKTEwIXfGXEdbop/zIpXrLgwX3EriNhAHtnSGTy7Dfju58PqXG/obuetBgcaO/D5ItmBLZxGy7AHTVGQwZiWOvQ+uPNlcxVpgP1obfuPrYDDX5oMY8np0yOJvCZhLnC7koKK9lzC9pu31Khj2bnuH215hEMSb/ELzt5EMz+BDZy8sqFWtRYEFeU/FNmoGgyYFvZ1g5qDRni9emOKj+asjUps1NqIAb08Dx4L1NORlVRmHKvt/I B61RB5fb lztwk2x5t9rxha/WXowN0clMpfJBMwW8WrxhXy6vnui/YxwyAssfXtarDO7XWT2RPfFpwc+3IyzF+KTuMWaYc6Sp+SlIdu2w3BDTm9rdkC29pianu/J+UxWpclnklNHeG23dSNAHDz7OlF1qw6RtQIX8vkTNHalBdHP7rS76gS5AWyFaeJ5p5VAmgMYgf+hMN3a72zjjALzF7JF45EjnXrgBCywJwRmKGsEizvsXEBRoUP8m/vVdNOs0xYiHaj4Vly+JkRFISioGDMyirjY5aAybvygkP038581tg+Vi1ZV8a1gFBPI4exVDpgg== X-Bogosity: Ham, tests=bogofilter, spamicity=0.000451, 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 newly added DAMON sysfs interface file for per-scheme-tried region's bytes that passed the operations set handling DAMOS filters. Signed-off-by: SeongJae Park --- Documentation/admin-guide/mm/damon/usage.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/Documentation/admin-guide/mm/damon/usage.rst b/Documentation/admin-guide/mm/damon/usage.rst index 179a9060a32e..a891e830c2a1 100644 --- a/Documentation/admin-guide/mm/damon/usage.rst +++ b/Documentation/admin-guide/mm/damon/usage.rst @@ -92,7 +92,7 @@ comma (","). │ │ │ │ │ │ │ │ 0/type,matching,memcg_id │ │ │ │ │ │ │ :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 + │ │ │ │ │ │ │ │ 0/start,end,nr_accesses,age,sz_filter_passed │ │ │ │ │ │ │ │ ... │ │ │ │ │ │ ... │ │ │ │ ... @@ -500,10 +500,10 @@ set the ``access pattern`` as their interested pattern that they want to query. tried_regions// ------------------ -In each region directory, you will find four files (``start``, ``end``, -``nr_accesses``, and ``age``). Reading the files will show the start and end -addresses, ``nr_accesses``, and ``age`` of the region that corresponding -DAMON-based operation scheme ``action`` has tried to be applied. +In each region directory, you will find five files (``start``, ``end``, +``nr_accesses``, ``age``, and ``sz_filter_passed``). Reading the files will +show the properties of the region that corresponding DAMON-based operation +scheme ``action`` has tried to be applied. Example ~~~~~~~