From patchwork Mon Jan 6 19:34:00 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 13927796 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 8D96FE77199 for ; Mon, 6 Jan 2025 19:34:47 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id A5F6D6B00B0; Mon, 6 Jan 2025 14:34:30 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id A12AF6B00B1; Mon, 6 Jan 2025 14:34:30 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 8B45B6B00B2; Mon, 6 Jan 2025 14:34:30 -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 5D4C26B00B0 for ; Mon, 6 Jan 2025 14:34:30 -0500 (EST) Received: from smtpin17.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay02.hostedemail.com (Postfix) with ESMTP id 18883120271 for ; Mon, 6 Jan 2025 19:34:30 +0000 (UTC) X-FDA: 82978028700.17.AF3065A Received: from nyc.source.kernel.org (nyc.source.kernel.org [147.75.193.91]) by imf25.hostedemail.com (Postfix) with ESMTP id 784DBA0003 for ; Mon, 6 Jan 2025 19:34:28 +0000 (UTC) Authentication-Results: imf25.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=sSnQVJsP; spf=pass (imf25.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-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1736192068; a=rsa-sha256; cv=none; b=7uJIXNc+1ZHrzcZQ4qFNvNOKQ3jORlDKegHWD5HRgz7l3aYepRlNOThr1HVR2dsE3OazIH I9QO1mjNJlzxPkrBi7Y1OSD3Ggb4FwkXdBzdy1+lRzxHUpKqfhxQbZZlsfazJwSXwjP5cl 8vmKEA6IfG/CxO2k5Ixbo5Hpd6CGYaQ= ARC-Authentication-Results: i=1; imf25.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=sSnQVJsP; spf=pass (imf25.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=1736192068; 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=F8Dfa+n+N2YzLX7uwrbcGig6C0R8OBtLHua41I+NQDE=; b=getK+DHVdNmQHypVRnURsbuk6ddP2M8vIFEW/x85ZVZSyvHpSa/wBOH56sytbx5jqwSb69 aoHOdSTQZIHtStGNEroM501Ub4b4RYIZEp0RdonRHRdCTBoklbC7kZ2Pot0q0zqc1igmC2 yVOvv0xucDiAnhpjTu/MOZfsmoWI5ao= Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by nyc.source.kernel.org (Postfix) with ESMTP id 13FD6A41905; Mon, 6 Jan 2025 19:32:39 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 6E106C4CED2; Mon, 6 Jan 2025 19:34:27 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1736192067; bh=rTeP/RjcXjYoOv0J/uUnolt0hy96UnSrvDc4IrgaeA4=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=sSnQVJsPXoRIaYHCZbDfi+aHFFaxuVkhI/cB/qynYScRZkhs0we/TK9Sa2gbVyLd1 m8neYW8nQcKHUeUp87tJQQPUGSmRC2MjP5+2G2lvrbVC0zBsNIKUvwNYP/Nb3ihXJb AGldb5ldLQbnaZi5GkHBWD77Aj6FKNbLjnXiasCGBSqkpl87p/clR+DhJwXjp5IoOt vZC2kEFVX/2mko5lFX0G6NUI8TBu6XIIY6rqGYX7PZ4zmpdyvCr3hWth+vjag//tW/ 9Y6h9H57N1sMOu1tJjm1LnpEW4fYtIIWBDwP+yD5MfO7kuVEMxwSZJPTUNr4z/RlKI Nbl1XYrT0gxfw== 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 15/16] Docs/admin-guide/mm/damon/usage: document sz_filtered_out of scheme tried region directories Date: Mon, 6 Jan 2025 11:34:00 -0800 Message-Id: <20250106193401.109161-16-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-Queue-Id: 784DBA0003 X-Stat-Signature: t5f83zxhg9hixc7ucpaxycr1bp63hkcs X-Rspam-User: X-Rspamd-Server: rspam09 X-HE-Tag: 1736192068-151693 X-HE-Meta: U2FsdGVkX1/871mg3sjcwP67dgb7ubdRhgpwNgeDedLA8+jvhwBPnrVFNlDpS2wBz3LHa1kV6KqnpfSa/yuOabTAU+2d05s5umhDSq57CwN6DVqn7FVJA42ntABQsyRtcun4tZLrC2nfTmd1BI2IN8WURmBmiCV9eLWMHhpzkThTCPNY3JRy+okDwbaz99/xA/G63tX7n4TK6FojXLOLkp4PBFbpc3IoGpEtMa4IQkRgrqD9sDRnfv4Cf43Z38Igc4uKfDqT+wVZSgCPcIQQFLdbH6K9p7me5ax3lW1/K3bi9jO/9ZEPzKbc4LqwAG+cqUap6s0ioJLmyNM+9B6mgwWzsfEnu1jd8yg13h57AKWEVBAFdBnbRvKTid/LeHA9WNM3HJyNabaFjvyhGa6KsI5UOt51Nzif/BhRdBfmhYaxLcEXVeVZo1Bus1/yXcsGJwu7tWKT25vFkTJzRWyEMjvr9CfiCBBmVeZqnYjWOuaShab2Wy8UVM+YI6VYb6Q741PlnddMucJEG9x2q/YrtwYoLESULz1rARaMSPPqcDjsWr2zwn02ei4kof1J1a7Vpkl64LzdIjh7WYfT/Y7kXt7ji04iqj9M+xxbZzcrhPokgQVh9RO1gejTRlyOLv+sMqcCIkK6dzmLmHXwEQ41gq/DX+w0GWA6CxVi76CmG/VqgMGc3jp9mnVF8JImlzWi+LzXdZQ+9vCHJuQY46fPoYh70myGakgUrFQ5tvSdyTgf0ai3/J/6prIrc3tP2DjxHs0QULPKLcKiBLAVdtxxg7yZRn9Nep38Oba6CWHVIuaWOEkonSRUuTCwN6jYChaPGf/h0okrtxD4EAV9L6MqDfMDbojHHPGZifYC0nHWDekqoHynbu214ueQcY5fSKoVqDlAF6gAgYvwYMkltg+yhPhehADcY/iI4G7S2Up4ro0J2un1KsMZEQ0Q/Pc7oqBVpHMpw0p1oTyfJkGJ01j C7+vs2BU Qc5VHqj9LMB3X3aouipQajiB9ULPm1qqjVkNSkZreQwnh4DbhvCrjEGRmQNpaGkSCUgQrJRYJ5S+aLUVXjAotLcEUJW2XJSKHXJQaJ/43LslkZYexCVh2fARGuwnn0BD1AgoOYeueDKu2O0lN+Zsxr0n0S1GztdXbOC443nOSBNxb5yYtMAjDawFf/AXnLoWQ+jvGh+LHwbO7qRl4+P6dkVShWusd/k8HkjH5wyF0KEn/jgqu45b+zGZqhwDaxZZvQDGxBMi2nm1yoETlDq5C342HtwnRMSO9AEKyIU+ayVIxlBLYePwU5HrXlw== X-Bogosity: Ham, tests=bogofilter, spamicity=0.000040, 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 95c174be9c06..71cf29ae8502 100644 --- a/Documentation/admin-guide/mm/damon/usage.rst +++ b/Documentation/admin-guide/mm/damon/usage.rst @@ -86,7 +86,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 │ │ │ │ │ │ │ │ ... │ │ │ │ │ │ ... │ │ │ │ ... @@ -494,10 +494,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 ~~~~~~~