From patchwork Wed Aug 2 21:32:20 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 13338843 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 760CCC00528 for ; Wed, 2 Aug 2023 21:32:37 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id A88222801AA; Wed, 2 Aug 2023 17:32:33 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id A38822801EB; Wed, 2 Aug 2023 17:32:33 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 8D7542801AA; Wed, 2 Aug 2023 17:32:33 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0017.hostedemail.com [216.40.44.17]) by kanga.kvack.org (Postfix) with ESMTP id 51DCD2801EB for ; Wed, 2 Aug 2023 17:32:33 -0400 (EDT) Received: from smtpin30.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay02.hostedemail.com (Postfix) with ESMTP id 0F76C120D45 for ; Wed, 2 Aug 2023 21:32:33 +0000 (UTC) X-FDA: 81080463786.30.6FC7F14 Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by imf01.hostedemail.com (Postfix) with ESMTP id 5132A40011 for ; Wed, 2 Aug 2023 21:32:31 +0000 (UTC) Authentication-Results: imf01.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=N8XK8bu8; dmarc=pass (policy=none) header.from=kernel.org; spf=pass (imf01.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=1691011951; 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=BQF35P7hXjl9TwWNqpj6Qfp3UJJFmpviFMibiLDIQgg=; b=SS4OIxsB+um3t5947/M+1rp8UfziWiBK9Q8Z4IR+moQ2uuEya/HABFCExbE4HA+s8zP02N NbIQ0Uu+XsnkMRgquxC9BAGTfrtnhO3EPqOlBoCNhfUh+7mdSYgLEJKzNkCotmhMZBohIc 4LoDrVSAc88gyfQxjy6SXiVitnnp2Nc= ARC-Authentication-Results: i=1; imf01.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=N8XK8bu8; dmarc=pass (policy=none) header.from=kernel.org; spf=pass (imf01.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=1691011951; a=rsa-sha256; cv=none; b=PuBOy7qcrIvfSP8hhK9KWdSRqu51H6T9BNNotI6zLBqdRs2CJCbV/UnUW8nTw+bTZPcEO3 GPMYD1mgdGmJgAaWFZ6KgOvKVJT/YcnBpnTf0v2lTcsTE4gax8OmSUN07dyqhfI2FEWFw6 xJiGu1WIWP9O6XmWrEO7RdTjaCcpR/4= Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits)) (No client certificate requested) by dfw.source.kernel.org (Postfix) with ESMTPS id 8B89F61B57; Wed, 2 Aug 2023 21:32:30 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id D12A5C433C7; Wed, 2 Aug 2023 21:32:29 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1691011950; bh=hZi4JMj8VgF69C/0cI6pgbuOwe9TusEzinxMwIrTwRU=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=N8XK8bu8QUF7j5mokMLp4WthiMSkYqCy1cY7HO0GbwC4arQZLodLipZSG5aSuS0s0 a3brhyuqU3Czlf8mRzp//Te0l/DLvozy4eCLuUXIeVuGhH9oAjBoGX4Kgw2glbMFfr r8ZRcAJavf+7zMP6kgLEFRY5NZlrtUIdQ966iL4IIWKYkl/wj4g46mtFXYANURfcCv 5ZKTfkfycATaFOVl56xgsVul41YgKaWOm/C1gG2UuYJBSUjCDXbBaSNr7qoX6bnPcX aoMTHxcWDg4YbhqjwA9oiUrVf6TTHyEEk+ESpebMbe+tARmMq//AJ+I2leTRzzfyls z6yzxG2O4nt8A== From: SeongJae Park To: Andrew Morton Cc: SeongJae Park , Jonathan Corbet , damon@lists.linux.dev, linux-mm@kvack.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH 4/5] Docs/ABI/damon: update for tried_regions/total_bytes Date: Wed, 2 Aug 2023 21:32:20 +0000 Message-Id: <20230802213222.109841-5-sj@kernel.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20230802213222.109841-1-sj@kernel.org> References: <20230802213222.109841-1-sj@kernel.org> MIME-Version: 1.0 X-Rspamd-Queue-Id: 5132A40011 X-Rspam-User: X-Rspamd-Server: rspam04 X-Stat-Signature: s9od4xnuhm3o98hatms63ps9ghzh6syx X-HE-Tag: 1691011951-736707 X-HE-Meta: U2FsdGVkX1/pTQM8Cnk3EbQAIJupQ1BkY7hEjpxZXextMDu80lUIHfpwjL0+chg3LDr88TgSAZIVcyCChVXVixNKWbmEq0xIS5JL5RwB/Bc9go2apsp2R7GQjLorTj0JJtmJ/xINXZOOrmUmbnKrIgIYElR3QGsMwOOZCiX6fxp9UnwY0S7foeoQVBq1Srlo5tm9vNYYy2usqeoj6lLZTpsbEak1h8SO75QRL5YfLYV08WN6HReDi5CI4LhWu7cJJ3s71itHPCt/Ccvgdko3SQM3PJsP1Fk6jOy7GOzxd+Y9/LVZB3kS3pQ5nrxUXMozdgceVfgPTEry7b83vJIGYl5BZYH7Qid+exK2+gE9jTCrU+juzHu3PFsbyrKw7rHOJgomF9gQh5Pwg2EamI7qwOyUY7WttgTGYzROVGClGu+dQOp/mAkLw4wN8Che9052Fvj8cEy8wuGWKTv8H4D6EsS3vky2bAMfukxGX5QUzHKO6+Q2i8q/5+l/3PBKo401+EK44ZWTZeB5a0zOz/Xw1XZ40eHPLXjQKuE5TZ88GiD15YhLzxOSt9AzowNtInrv0XgXPUKsmIe+45/XkbhyEa7FR46VG1SC9e8loc8tpGZInxlNfh+ay83AlpTYJ8WTKFDIay79Vx3ookttVhLtU53BdBH2XdEbqIgMgQ3XzuWyMQRxNl2wXP/gFZzBYl/5md1THIuJdPN+BzEH5zV2qmN8k3WbrxReO8i+K1swBOLTmyDzDlGS1mXVSQcVqKifOiFRPhxDK7hZEePW5cZMyjbLqhK4Dm4L72QIC0wdJvGdrTASniOqAxosn0yR8K2uy2Q1t9o7YJEHfzRoy/wg6EwEWds4cYmJ3yr7VnE09v8bLFqHjakmRmYXothjjCFMPgPJwSgo8XZ08I/nTdFc9QHsF7xivpraH4i/VhYUaTI8FEkpz9v8bHABgYT51Tyuue+v7eBuBX5cAsMEGmI oGv+UCCc zI+LiVPs6mIpC/xULyR8XhTxFm+16nseO9ac+wJRDDzbE0hWvtvmO7ilLTNgmrMvAzkQnuTDyrxptIP3cbwJTiWBCPX2afpzciNgt4AxLEx+Lpb+cb9MQPy74oQVVbgOvmZgpr9Nxl6kwJ4dSJypQ1m/T27++0rGxS3Pc8hAMlZy4t6AuYR2M12om63PoiyJQ7d2fvKJZ6vRHBw1LI3SSG4QsgIVhLNGLJ5FbwPpC9OWu2l/HIts8u4Ipvrh0Ex5usd4z6L/Fr/8+Tcm8XSHHbFWwjtjQHn8q4JDA+rdCZGLGqif/x661Xt8tPCRJWX2K9F4+/XMI1RegDtNTvoJTXz1evGMN+YnmXqp6NwgJOG6TxPMaCYCa4XUk297567jOnIZbwLg6zr2ig+XArRt+VrBUewpr/0MwOTESQVzipxYyiaPw2wmAA41vwsTZpYZQd6tW 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: Update the DAMON ABI document for newly added schemes/.../tried_regions/total_bytes file and the update_schemes_tried_bytes command. Signed-off-by: SeongJae Park --- Documentation/ABI/testing/sysfs-kernel-mm-damon | 13 +++++++++++-- 1 file changed, 11 insertions(+), 2 deletions(-) diff --git a/Documentation/ABI/testing/sysfs-kernel-mm-damon b/Documentation/ABI/testing/sysfs-kernel-mm-damon index 2744f21b5a6b..3d9aaa1cafa9 100644 --- a/Documentation/ABI/testing/sysfs-kernel-mm-damon +++ b/Documentation/ABI/testing/sysfs-kernel-mm-damon @@ -29,8 +29,10 @@ Description: Writing 'on' or 'off' to this file makes the kdamond starts or file updates contents of schemes stats files of the kdamond. Writing 'update_schemes_tried_regions' to the file updates contents of 'tried_regions' directory of every scheme directory - of this kdamond. Writing 'clear_schemes_tried_regions' to the - file removes contents of the 'tried_regions' directory. + of this kdamond. Writing 'update_schemes_tried_bytes' to the + file updates only '.../tried_regions/total_bytes' files of this + kdamond. Writing 'clear_schemes_tried_regions' to the file + removes contents of the 'tried_regions' directory. What: /sys/kernel/mm/damon/admin/kdamonds//pid Date: Mar 2022 @@ -317,6 +319,13 @@ Contact: SeongJae Park Description: Reading this file returns the number of the exceed events of the scheme's quotas. +What: /sys/kernel/mm/damon/admin/kdamonds//contexts//schemes//tried_regions/total_bytes +Date: Jul 2023 +Contact: SeongJae Park +Description: Reading this file returns the total amount of memory that + corresponding DAMON-based Operation Scheme's action has tried + to be applied. + What: /sys/kernel/mm/damon/admin/kdamonds//contexts//schemes//tried_regions//start Date: Oct 2022 Contact: SeongJae Park