From mboxrd@z Thu Jan 1 00:00:00 1970 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 9B5C8EB64DD for ; Fri, 28 Jul 2023 20:18:37 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 99B516B0078; Fri, 28 Jul 2023 16:18:31 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 948BA6B007B; Fri, 28 Jul 2023 16:18:31 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 7E9628D0001; Fri, 28 Jul 2023 16:18:31 -0400 (EDT) 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 6A83D6B007B for ; Fri, 28 Jul 2023 16:18:31 -0400 (EDT) Received: from smtpin25.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay01.hostedemail.com (Postfix) with ESMTP id 51FD01C92F3 for ; Fri, 28 Jul 2023 20:18:31 +0000 (UTC) X-FDA: 81062133222.25.ADF9FAC Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by imf29.hostedemail.com (Postfix) with ESMTP id A6C95120024 for ; Fri, 28 Jul 2023 20:18:29 +0000 (UTC) Authentication-Results: imf29.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=QyGP4+cb; dmarc=pass (policy=none) header.from=kernel.org; spf=pass (imf29.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=1690575509; 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=nDQPgkUB6DAyKlL4SkcqKDuA5nvxArqZJpRtjQx3BBLNqS5CHp9EK/VCVstYOSf7+c6M3y 6+LddN+pgcTLPr77kJ26TJcc4h9GBfePmBoIn9EvSLjVNa8poALzHCuL1MguWR/lr8WOCp i+zest/b/ZCOAkWfLNQCidMLnz2qCPk= ARC-Authentication-Results: i=1; imf29.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=QyGP4+cb; dmarc=pass (policy=none) header.from=kernel.org; spf=pass (imf29.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=1690575509; a=rsa-sha256; cv=none; b=jNWuc65aH78h68d+FmiO9s0ziKWU/Auc4PMdoV+yUxq5+8NmUpVDDT79OKZj4kHEOu4InT 6JquBK1EC5wyhnyPYIeKvvdqbmFDuI4O1nmebiUCdljIwzbHbMTCGecJpyUoyyTyDRU+N1 744SrSgPKHQIMOGJVsjw9w36Xt3zZXw= 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 E8002621FC; Fri, 28 Jul 2023 20:18:28 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id D5926C433C7; Fri, 28 Jul 2023 20:18:27 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1690575508; bh=hZi4JMj8VgF69C/0cI6pgbuOwe9TusEzinxMwIrTwRU=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=QyGP4+cb8vPs1cOqldkfI60vHEt6GW58BND6QKRpWnpRyPcnJjNzbMiHvKbL9sr2f Gd89fZUVgnWzXVJE8Ov8HLUGJen9Lw5jd0RX+XIcilGNjDfRSNkWXm209E2KRuCtPa F8UY4Eqc6arjvEGTVzBSN1mw2IhBvPs0jAE5IqeK9kzyWeAGdTwB3M2ErhdHYFsl4G WV9PSZKsagHHQaKljpGc9LWz6H+qSthGrI3dMvNDLEQyaQblO9+IIv3nDwE6+65d83 cboN3H1SPsHUB2yduqbBqlYlsgiU5j7gNat2nzF1OVPsWcoAlJN+yhrt+M1hPRY6Y1 cPpjkWwWV1JSQ== 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: [RFC PATCH 4/5] Docs/ABI/damon: update for tried_regions/total_bytes Date: Fri, 28 Jul 2023 20:18:16 +0000 Message-Id: <20230728201817.70602-5-sj@kernel.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20230728201817.70602-1-sj@kernel.org> References: <20230728201817.70602-1-sj@kernel.org> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Rspamd-Server: rspam09 X-Rspamd-Queue-Id: A6C95120024 X-Stat-Signature: xy735n4kju41d1obyidx1wi43aceket4 X-Rspam-User: X-HE-Tag: 1690575509-915589 X-HE-Meta: U2FsdGVkX19oKAp6ED+LYpmkU0B1/QkW5C0Bmgo1SheFA/zPia78J54TJFk+3Q4XcagcTy3JnaSG52ANdLSu4OSSPiEeyfTNsYKWX1SEpske+Y3k7Tlj4hKj2mnyf5+tD6BPDoVl1lly+QtTJEm6ZAM2ZmgqpYMfbpq0T6MqmxrYvsCKkiedUl20pMZbrWWZapnrECmmunB+/WLJLihmBRvmncE/pLlTOVgKRkRg+8IK3CGqKYwn+apgd1o4BnJnkS/qKg/nJsX2jqh9WFtKpFJNikAtUuM/pdKYbf8TDqmK/rfkH9BlzS1qV6WDWxHuGs/MnHN/O871GsfMw06lm3XlMOhmKDABdOCJEjseD5nxxfIwgwpl2fLwZSsZ7Efimp2u4p0mATxV2tDuVcF1LX7GIsTfrqY8JRF+MYylFaQkEoIN9Aio+ZuD/yYRQsED+m3iK1srYh9XetY1+CUZhUJjG581kKH09bsHBYMnC9SfIwbFPCGjSxHRkjd17RFRBHa/44Htoas2d4DqjcmdJ7IY0hfJOkupyLYRfnPmLvo+/XzYEANPZvR/98jAMZbQNeqNinYZVAjYZccI7y6WG8F/GkGrHRScYkWerabxBk1A3do5pFD0eWEfTGJhSf88RYhsgBzDkDFenugth2UoO7DRxo6jNMz+IDOf/bpsjvgvc4v4ZUXOThAxrkpj/WnE9n1QKBlPPT/cTY49CKySgjxGekTc8+jQSQFPHNzgF/I5oiRT+1L/UsNX31qjJ4HRAnaey7rmVZpL/0HPNaaMPOdEDvsKYPMIIT1hFcIRfzyATgCrNAZi8QI0SoBySAVMVRAeh5TslRzw9479mDpm3AkVsWQt74V/ANyGcM2WdWRBZHeHdyXdWcjOU+supk79faDlfW3vKK+Zg7/V+rTZxyro5xjtHZUJOhgUzMwPYyogB/yUsRwbmR01KbRf6X64A37kSk/w+CxcfLwYBVW bRnScNDX 5a/W5JWIjB+DELS7104yHrFgVLyf3FAkDuM8f596zRb/oxN2DpwD2WdENLNQNRFh6cPaJ9C75HyObqjZ6cLdI3J0Af9wJ3aLYtSgGGtILikmRo1SlMymc1ud7bXgZItfD2bKMtXEzOtHalT9BmfwDbk0mUdvV4efpAzAKUDJLInWY6EISQTXylY6dOC72wqtFCQ0cRQ+4L69joEvo1Izt/mRDJ0b+XmH6DQTYSQiFQVeQ/igRRPdZ8E0PnmdXt+jYf9pEADz3Ga67/GZscMyRvpikJQJ/0DdDgj1PBsX/kZfuZ6j+v77utNCb/XBe+CD6MlM2k4UJ/pZOajSrOhHXs346heEzKCzie9I3dm6KbpFNHoUbzrSJnrWa+Gtqn6HEbvhiHg2Lybiyb13/+PAA+s45vmUtcgVzCUj0T/3giqHCz3y7S4nAsJ+l1oZU7TOo2/co 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 -- 2.25.1