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 88741D65551 for ; Tue, 26 Nov 2024 19:43:54 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 13EAB6B0089; Tue, 26 Nov 2024 14:43:54 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 0EE8E6B008C; Tue, 26 Nov 2024 14:43:54 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id F1F116B0092; Tue, 26 Nov 2024 14:43:53 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0010.hostedemail.com [216.40.44.10]) by kanga.kvack.org (Postfix) with ESMTP id D58916B0089 for ; Tue, 26 Nov 2024 14:43:53 -0500 (EST) Received: from smtpin19.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay01.hostedemail.com (Postfix) with ESMTP id 91BBE1C7C88 for ; Tue, 26 Nov 2024 19:43:53 +0000 (UTC) X-FDA: 82829271336.19.13DAE80 Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by imf22.hostedemail.com (Postfix) with ESMTP id D2664C0002 for ; Tue, 26 Nov 2024 19:43:45 +0000 (UTC) Authentication-Results: imf22.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=JXMb1yMj; spf=pass (imf22.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=1732650226; 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=XqX7Ay8imGXOzs2Vy+nVunCXx9tmu3gLFaS/6EhC4gE=; b=Tv90BwQoBdMSjWxL+s1raw7KqD3a0mj0Hrp81ss1+HZCsbD27M3l4qALCAiOgYkAgqEVSa rZGWppDSEFS7s6SKsarBxPDwxuqzs2R8Zhm4P6KskFpkLj4EaZgwG6zbFURExtvkMJXPTi kIaXVJYhwN2StT6vqPohCVgCy92s2WY= ARC-Authentication-Results: i=1; imf22.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=JXMb1yMj; spf=pass (imf22.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-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1732650226; a=rsa-sha256; cv=none; b=oyKMUkzWS+YWjEN2H+vH31iFM05sfAiOKJEVA8H9b76TnmJD67EyB7o3Z2Mcb+J/HvNoDW H0N2kaWXFL1019ZCGB6hHVUQFnTwspGBnRG6RbI1qg4aKI+h9sm8ecmV0OREZkRzdkSAH9 /+wQI+uvvhvg4nAvLB6tYXm1ntbpoDI= Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by dfw.source.kernel.org (Postfix) with ESMTP id 7997E5C581C; Tue, 26 Nov 2024 19:43:07 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 6A3ADC4CECF; Tue, 26 Nov 2024 19:43:50 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1732650230; bh=hUEJ2mm62pyewmPyILbKuAM0dRAk+OMEv4YUZmgG9k0=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=JXMb1yMjnE200+j2SCCTKsA8wAY3MsS9Rehl6V8oDpy9FmJ4WYUiYHc7O5IQreKef Ydsk9IHy6cBId+mF5kGmpzS1WhWkZcF2uYt+6/V8X4ksgPSoTEXTMFI976We6Bs5sz 9I/OT09XyrCsjZ0Wjck0SHOoVt/n4AiBqX2VifVxg3Aeg+eFVdHFid5prsPlILmtKn 9Hh48gxKa+2vyY6YTJNky65u4QAx2XkCfvqj2NO9gQIiuBzeyVmf9RKgCrWQ/cO456 +7pVxPGs3zw2lDvwqJmFKiJsntbxBXP58PwJIhfTAqxn08pQnpYikraXW+fuXr+RX4 cg/GA4nqjI/yA== From: SeongJae Park To: Honggyu Kim Cc: SeongJae Park , damon@lists.linux.dev, linux-mm@kvack.org, linux-kernel@vger.kernel.org, Yunjeong Mun , kernel_team@skhynix.com Subject: Re: [RFC PATCH] mm/damon: explain "effective quota" on kernel-doc comment Date: Tue, 26 Nov 2024 11:43:47 -0800 Message-Id: <20241126194347.58155-1-sj@kernel.org> X-Mailer: git-send-email 2.39.5 In-Reply-To: <20241126082436.1491-1-honggyu.kim@sk.com> References: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Rspamd-Server: rspam06 X-Rspamd-Queue-Id: D2664C0002 X-Rspam-User: X-Stat-Signature: jk5h5bs96w5nsntroucjpkgxdfrko954 X-HE-Tag: 1732650225-384297 X-HE-Meta: U2FsdGVkX1/jENjtJWKucJScdWTEzp6e1JnzrMrmia84CCtwvmqY5xZenk8Gd+AYmYCVwYqkA1ewa6iJfOptuh7ot6ULpzPeVjwg8DwpADeyEmxfivuCRQ5K2i4IPwUX9Zy49bf0pQ/qQZwMOKrG43PoiNTAhziZG5A1qVaxuyZ8g+n1AueRE37iTPMOey6caEqEy6KmmZT2m0hDk8XpfWVLG3S48SYPY5qyzuGIqE0yS4LPAeV+YBZiZbX55KFINwd/UrXlHrOe3OUkU8xIA6AQBfgRPzNs//94BaDZaNCFnt4TwIRKs59YIlcPY0Lj0TVbwOvjyH3FYIVWalgojCOQKDQhiwJaNd39I3ysTJOVeeF5U2qRpuUIor3NKiskAyHnfg61McyEpSzvFln+xV4sazpY3yUWU+eBycY4/79rcUrouMDZpcoR6BVGRGrIW2GrecDO/nZ6NYCWtu1T2to6u8j85dVVhVVnCJWPStrjf7ujjRGRE6jkPG5MqpYJjZ3xO3rYXymf7EoHHO8tO0h+IAbloMpRMEkInIG/ry6d2zT9w0fNNGRMocOmxDEbilJKmSqokbzf3ViQV3BHQvIihCRa6IXWnLOtHCcy0e/68k1vY9kekU/GMg2WESeo9sREAOwzZM+z9Im4WOTIH6AwgPpdLk7EaPklEYc66DFzbt1E/2WxJwc3C0ron3twLQNSFvKlqB/FNhVMBIb5CbM5aK89tlr4aUm7+sj40BggyFnv7TZgRWnjSM+xDo0F7xJJvRws+Ed1J3BdoRzbXu4OLyVIIwplyxV3kM0bzYqDzmaiJZX63vGPYw/5cG16r3epYoTJm/W9iO1q3DzjA+DejQJh4+lZdtqbvoBVAJ8CdcTI56VkZBdbnFxBBDemq8efEMZjLaNcO0OUqGfQSq1xpLhqS+5kXdfxMIK4x5fPAeZWUEILhLy6x4il1LJku5TXXNaBIMmx+lEa9Ff ZPIjeMpt 3cRFehQJFjWH+iwlusi+UnpPM7oNgFexQ6YJWolIsY+pKnbOSQf6+zy25dtKMMy0YADtlObgGFg97RmJD46jHoSo2/S8Xjh9q5rWX3oO8v6gHEdypTsAHYrSjqeWfJ/UfJwxIMYT9nKzCL3iRjGR5Cix1rEXlp2ott/nEIku74/3NemjhjijG4W8K9pdSsoAkIsKAzpBGvZlc/nMzsMKCXvjmsJcZaH6V/f1wyIS1J0eso2CuIMj506OI9nS5bnuSgzMxtpu0H6AaPVhzvNi5LbGQOMjLG7rSnoU807bQLfvrQCI4cKzDsWix6g== 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: On Tue, 26 Nov 2024 17:24:33 +0900 Honggyu Kim wrote: > Hi SeongJae, > > Thanks very much for the quick response. No problem, all owing to your kind report! > I think it looks great but I > have some minor comments so please see my inline comments below. > > Thanks, > Honggyu > > On Mon, 25 Nov 2024 16:29:21 -0800 SeongJae Park wrote: > > The kernel-doc comment for 'struct damos_quota' describes how "effective > > quota" is calculated, but does not explain what it is. Actually there > > was an input[1] about it. Add the explanation on the comment. > > > > [1] https://github.com/damonitor/damo/issues/17#issuecomment-2497525043 > > > > Cc: Yunjeong Mun > > Cc: Honggyu Kim > > Signed-off-by: SeongJae Park > > --- > > include/linux/damon.h | 10 +++++++--- > > 1 file changed, 7 insertions(+), 3 deletions(-) > > > > diff --git a/include/linux/damon.h b/include/linux/damon.h > > index a67f2c4940e9..a01bfe2ff616 100644 > > --- a/include/linux/damon.h > > +++ b/include/linux/damon.h > > @@ -193,9 +193,13 @@ struct damos_quota_goal { > > * size quota is set, DAMON tries to apply the action only up to &sz bytes > > * within &reset_interval. > > * > > - * Internally, the time quota is transformed to a size quota using estimated > > - * throughput of the scheme's action. DAMON then compares it against &sz and > > - * uses smaller one as the effective quota. > > + * To convince the different types of quotas and goals, DAMON internally > > + * converts those into one single size quota called "effective quota". DAMON > > Could we use "effective size quota" instead of "effective quota"? > IMHO, it will better give an idea this is related to "esz" in the code, > which means effective size. The above sentence is saying it as one single "size" quota, so calling it "effective size quota" here feels like unnecessary duplicates of the word ("size") to me. I'd like to keep this sentence as is if you don't really mind. > > > + * internally uses it as only one real quota. The convert is made as follows. > > (nit) "as only one" can be "as the only one". > (another nit) "The convert is made" can be "The conversion is made". Nice eyes! I will fix those. > > > + * > > + * The time quota is transformed to a size quota using estimated throughput of > > + * the scheme's action. DAMON then compares it against &sz and uses smaller > > + * one as the effective quota. > > * > > * If @goals is not empt, DAMON calculates yet another size quota based on the > > We better fix "empt" to "empty" together. Nice catch! I will fix so. > > > * goals using its internal feedback loop algorithm, for every @reset_interval. > > -- > > 2.39.5 > > Thanks, SJ