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 D5852D70DE8 for ; Thu, 28 Nov 2024 17:50:53 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 086DB6B0085; Thu, 28 Nov 2024 12:50:53 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 035DF6B0089; Thu, 28 Nov 2024 12:50:52 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id E67936B008C; Thu, 28 Nov 2024 12:50:52 -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 C403B6B0088 for ; Thu, 28 Nov 2024 12:50:52 -0500 (EST) Received: from smtpin09.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay07.hostedemail.com (Postfix) with ESMTP id 81ACB16060C for ; Thu, 28 Nov 2024 17:50:52 +0000 (UTC) X-FDA: 82836243924.09.C45F242 Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by imf04.hostedemail.com (Postfix) with ESMTP id 831254001A for ; Thu, 28 Nov 2024 17:50:41 +0000 (UTC) Authentication-Results: imf04.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=AEcYfti9; spf=pass (imf04.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=1732816244; 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=73TA4DJWLFJaMQGj1FpaYfV2upNz8DqUhjpm70rsFuY=; b=xf/iqVfYeEvPVCRNawxyB0AnW5YEsm9qYvVtCgXb2Bj9gDWauyTt30RLk6xB4ZYvXZ36lO SqYHJINwDvUTY+vMQr90IhQ4iMZSv4q1fAPA6fQdQ8yn/ycp/Sr/VyWKRYjONyMR/ySUk0 YHMc6Bj9+5/3vpKRb9NQ/juhNoFCWzU= ARC-Authentication-Results: i=1; imf04.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=AEcYfti9; spf=pass (imf04.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=1732816244; a=rsa-sha256; cv=none; b=gJq+UUjF7EhLbzW/ounkmPBUrmTxlTXOZssYkylHB2d5MLR/YD8g1h7/e7ZQV2Lx/Jn2WS s9v9WCj2q5RP8jSLIiNZ9M1SAvoPrYn149aVVlh9snZoEDshmH3rjq7TCr2U3f8yN2qgNx gIHUlDgCaf4vd4Em5/iVJSQ46PIGhcg= Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by dfw.source.kernel.org (Postfix) with ESMTP id 819F55C03F2; Thu, 28 Nov 2024 17:50:05 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 52D48C4CECE; Thu, 28 Nov 2024 17:50:48 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1732816248; bh=4uzwBgLdANxp3xPDpK+HTjhj4ebgQrIW0HuWcaGrwCk=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=AEcYfti9AGZip33OkET++gHH8tKanuXiv0orblAoXmZsAj8ADmsGKgA8bzzenrwnB PecU1vHbb036NnrdlNCWubM8tZaXK+yLqiV9HkLJ++cCloSNCh3p+FuYph5yhgzwrk i2iY/TxgZE4iNmMuMYE14I0fEUE9partQ1zbsn2oIDmj0E4A8C53KT7j40CZuq6PYx HIgdzRBj+QYSu0V9QlRQknNu83q40OkM+R4NbMSyMCRbYj1tq0e/jPIsbl+ax+ld+e 7cEwybNXb+S2r2H85M5ZJCS3fwCHTJXyIHF3ZYgZnM13/msmEM5uQBMNKraj+YIf+N cmKMh1hyY3MFw== 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: Thu, 28 Nov 2024 09:50:46 -0800 Message-Id: <20241128175046.87869-1-sj@kernel.org> X-Mailer: git-send-email 2.39.5 In-Reply-To: <20241128095357.1530-1-honggyu.kim@sk.com> References: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Rspamd-Queue-Id: 831254001A X-Rspamd-Server: rspam12 X-Stat-Signature: q71mdd9mzm6z5es8hhcdtt6g6nbo5run X-Rspam-User: X-HE-Tag: 1732816241-307402 X-HE-Meta: U2FsdGVkX18jFn1Bqps4+Ky+As29ua8j5mLhveCz3XAijrxoqwYH6ynHy7EmhH303GeWIL5wueT3QN7O4YlefZaC9UcEsSFqMZftUuxip2Fxp0NQ98rFf4qsG2LurbAriJ8kQWn4j98kPsdB1u4LV8wmWgo94t1eReDPuVKVMxigIdof18cvoLi0odPg7fzB20AA1gJguCma+vsajV51N19kFx9kHuurBDNioSFDDPrB621i3u+xufnOa9n2YpYPY+x2FlgfaphN2TD4zvmPdarw/HALU/p70Fpj+fv3u8N71RokRKzgAvY5/nZ1KOg8pRV3fTU8DOSRQU4c7ZiUsZOYp1Y3Mmy0gSUfls1p41bfjwALzq2jJ1JEGnZhV0oETFxyIp9Y1z0ngwrOEVr51Y97fFIO97h9maLWoRkPVBnMKq6U4NjRIhDVmAjWK4NWgNXCoi29fFHOGqX3lWeCMgM/qIOmwik8bjsATNpt+9n3O0JxeeIltQEYzHCuyW0XdO9i/bADe04iTVwwh967j0rtr4vvIKSXvF+l/chlgbA1H79FZJa3b/Cs0Ih59eJC95iY2+S+5Nlpr89YpIkdZjUhsaN/UNaqgeOWoMtiWqtEshHOBREW7YUQVSyX8TGqmakYLZtQ/PHUKpnv7V/uQvdU5gHo+JeZKVZIqca5e2PHOI5M/c9iUMVAllxmtZFvyqPvgVqO2tbTXZnDQqeumg93iezhdruJGOyh+WDmdBWi5nKlupOCrfJHzqh4+7ffy39ymYLL8tkUwrqM7pYEvDNXirXh6QeN5yp5f5GjwYoOlO/FSAzPrgPa8ZvdQ6gOLi/DH20O6eki4PPExcAxs1pOM2x2OZfjuOdc6oSuvym9ffXsmpqLmyd40IPoQg38UpfsocyD9bMSmic38/eIAOZo2BEDddRTNs5mLAtWyNQczRZHRw9EPvd2Aht13otq6tJwfAcCBuqYro/Gkli IaczkLuB cGKZGOo/RL+WOQ34K0+wSEQkNBkRUjg1IROTSwPtOjAl/N73Yjwf6iTHqDP1uoTG3WtwOxkjChBU4XOcJLdiaEyudzQan+WOylL2hZg4y86gFdNGr+miCVHlaQaVAgzm7x2S5q8dUezHkumLarEUWfQ2eieTZTY+uAPT7TBL4fwySkXBvooXwmlVx0Vqr7pKS60JbLBB/w/TJlzHw5ZatTOxHDABNLTWdyhs3+kT9Bt0pnGT7JKpYgr3DzCIJxNwQKBuWtEZr36UFe8whQXOnN95eMx6zTkrmUVgMgAoruA/zfmzJ8ti4z6YNZQ== 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 Thu, 28 Nov 2024 18:53:55 +0900 Honggyu Kim wrote: > On Tue, 26 Nov 2024 11:43:47 -0800 SeongJae Park wrote: > > 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. > > Since the time or other goals are eventually transformed into a size > quota, I thought the "effective size quota" makes sense but I won't > stick to my term here. I understand your concern. But I want to make it not very strictly fixed and well-defined term, but just somewhat understandable with common sense and given context, for flexibility and conciseness. So unless this is really makes it difficult to understand what it means even with common senses and the context I'd like to keep current form. I believe your answer to the above question is "no" since you mentioned you won't stick to your term. Please let me know if I'm misreading you. > > We originally asked this question about the term "effective" itself as > we didn't find an explanation what "effective" means actually in the > doc. It'd be better to have more explicit explanation as well. I think this patch makes the point pretty explicit, so my humble brain is bit confused what "more explicit" really means. Could you please clarify what changes you want to be added? Thanks, SJ [...]