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 2D022C7115A for ; Thu, 19 Jun 2025 22:00:42 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 615276B0089; Thu, 19 Jun 2025 18:00:34 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 5772C6B0096; Thu, 19 Jun 2025 18:00:34 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 354326B0092; Thu, 19 Jun 2025 18:00:34 -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 1B4106B008A for ; Thu, 19 Jun 2025 18:00:34 -0400 (EDT) Received: from smtpin19.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay03.hostedemail.com (Postfix) with ESMTP id C5906BE0C8 for ; Thu, 19 Jun 2025 22:00:32 +0000 (UTC) X-FDA: 83573519904.19.4E013EC Received: from sea.source.kernel.org (sea.source.kernel.org [172.234.252.31]) by imf14.hostedemail.com (Postfix) with ESMTP id 0769B10000E for ; Thu, 19 Jun 2025 22:00:30 +0000 (UTC) Authentication-Results: imf14.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b="P/Q3Veqo"; spf=pass (imf14.hostedemail.com: domain of sj@kernel.org designates 172.234.252.31 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=1750370431; 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=LgOWexsahum816uCHtxZxh2suS23mkZM8ckdAkrWMc0=; b=VkgXOiXLepDVVw55COaoeFSHBWqrPtdikEXETpX2eezFOdFSvzUX4YT2jUwjwrzWvNBZdp 8mILfBrjmALU0b3pJjwotiG392ZZN66XztkZBhXryntAZ4hiqgwF//fQRgHaafT688xTBM w7xkAd486v5CXGRbUMC5KHMymLOTrUg= ARC-Authentication-Results: i=1; imf14.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b="P/Q3Veqo"; spf=pass (imf14.hostedemail.com: domain of sj@kernel.org designates 172.234.252.31 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=1750370431; a=rsa-sha256; cv=none; b=ihehYu13tVQ1vvFc0bPjKVRg/0Q/5j2L1TDS4qf223X11v5s080hGJnG5IQV2LLcp/gSgt cHQESAs6HQJxQJPHiXYHp9cSWEUjFXm1TV5k5ObDGFhSa/e9Rrc3/Axui12nbb4MzC0hio DZIwgVI60uEpSUkXt0hPSwGb2ggKjzA= Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by sea.source.kernel.org (Postfix) with ESMTP id 0B8F449F9D; Thu, 19 Jun 2025 22:00:30 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id B789DC4CEEA; Thu, 19 Jun 2025 22:00:29 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1750370429; bh=FL+q0PIy56zCfoaOYFZdf7xArsaTKGHGS5paNyqWubA=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=P/Q3Veqo05zrRL2NWOdDsxRdXpHEILquWBMELgpQQ+DHnYfM28d0FT3gKYgf+yWTK JD5nvU2IHlyLGPDsCVWVQOUWvlsHypgC0wMYEJFPXtMm1fIVOGjk2LAYUFUQR5RdbB kGPZy/sLuh1bTkF2xaN8EVEt/eVbXlQbDM7mQetqMVgCbCGi82o9E3+Z3/R4K0900J RBPGyTZLWk1EToSRSeo8Q5ohng37MlsDK8w4nR6/7Z8Uy/t0gr5ADcoLPMTLsfG26b jFG4k+9qjUBBTfcjlThWs0SZ7SXWZHYg/GJf/+NW9HW/cqtY9HN6JnjlDAAkWJDAvi CDWK2sXkAxy/w== From: SeongJae Park To: Cc: SeongJae Park , Andrew Morton , damon@lists.linux.dev, kernel-team@meta.com, linux-kernel@vger.kernel.org, linux-mm@kvack.org Subject: [RFC PATCH 01/11] mm/damon: document damos_quota_goal->nid use case Date: Thu, 19 Jun 2025 15:00:13 -0700 Message-Id: <20250619220023.24023-2-sj@kernel.org> X-Mailer: git-send-email 2.39.5 In-Reply-To: <20250619220023.24023-1-sj@kernel.org> References: <20250619220023.24023-1-sj@kernel.org> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Rspamd-Queue-Id: 0769B10000E X-Stat-Signature: r171wzqpq38sxf6w8fg1ma56upwy6ko1 X-Rspam-User: X-Rspamd-Server: rspam04 X-HE-Tag: 1750370430-69862 X-HE-Meta: U2FsdGVkX18FwELqnUGksfHxRT6GDnrJnJlcO4SYFgjmntoz9J/xFTTGdXUqoKH8GgXeBJZbDRYfUn4z5Iey7BTpwWNJUO2Bo0E8YpY07zL9hVxPqml3Z2qxn/hXrCLQ23ikN90rF0DCMOLOKBbOLkkn5fIg93EdwAYO8DrAfFPYSbDw8ocaPwad5x+jaivg+CVnpxGPbJxnd+osWS+egrJP1sq4rWJev5L+Gu6r/v/h0nGESVjIhju2g4iarzCB1DShWmavSIkYtI5PXxEgLBJckXKHgNCCULReUZv4HSBr/WBk3Z1ZhkI8LkW9qh8cepZS01DfkiZquZTXhx+XxnX982yjnToT9hBrSC46XggwSJR70yV7VaL1RFTbJ0Sp5RgF5VQJHOly2hMBBw2HmyRSDxR+/ppI/xbfu4tssfBLl9r8+IyVJ5hbGw/Khqgm0X45BLZE8e+SslS1oPgfFyKLG9eMglkO8ilqmQtRbtjKS32Mnr8Sj4P97mKVRxnWMNGZkLCNeVerEzovG5dKzC8dlPpysbFJ1rWoPuUEwguHWsQUiFH49qAxRcioZGcJttsX9jb+IVD/mMweqzhmTSAaKPiiaBv2qIfLerhKi1gBMxG/TUFXicZXcLjWhgyciSMQIsxTw4icQO7jfgizKYTV71khJnUM1tT12j5bmaHMf+RLTOiwEYTNEpRuXTv3wPe9RhN4Lh2Fb54PebIe8bRhiEIJGUSMYog22wbWh3ilVa7taKYfmMtZcAsNV0AXxgsqIki+L26QTh7bQ1v9ZFdauZDt8X2KTPZLBUSwn442a4rvjCZTxasLrg+fOpepMG4uc9dHXOV+1MS++lS6QdjHMjQavkk+bp3ohRLBT/rBp01voJyQFoi4ftG6x21kxSK3gOrM4CvGYnZxOOd+I4tZZq3UOXjqtAasqFMcz6VbTiqcmBbZoTL4vAccB4WX5nQseNZU0IcY2JvkkTW wAgbwEr0 fXJc4QQ733NvZjqMSRhtz4SlBlqUoog+bgmnwPESJgHtRJ68DV9/RM1GPbW86pROcuDko4tOn/04S/BBUnz1Qjp6glYVJGiQyKpSeMKXdMTa4khm+tZsnLCfFwE+1ZYdG3bp7Ln7SMOCkcl8MDqjq7QqidVwdAxqA2JNrTorMRzKHU5U9SwOCNZmu7p0hvnxmq+q7B8sVb6Fdm6rQfe4rF4519kCaDFvZ3cNgXapZU8hdnuZmBtE8NuQsgcaKz+FTR4lWIKYEop/1t/q7EAxCFY+FD8iAzDCcordn6S2TXnZ4vS4= 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: damos_quota_goal kerneldoc comment is not explaining @metric use case. Add it. Signed-off-by: SeongJae Park --- include/linux/damon.h | 3 +++ 1 file changed, 3 insertions(+) diff --git a/include/linux/damon.h b/include/linux/damon.h index 492be8319a25..39b835dd3c4d 100644 --- a/include/linux/damon.h +++ b/include/linux/damon.h @@ -206,6 +206,9 @@ enum damos_quota_goal_metric { * If @metric is DAMOS_QUOTA_USER_INPUT, @current_value should be manually * entered by the user, probably inside the kdamond callbacks. Otherwise, * DAMON sets @current_value with self-measured value of @metric. + * + * If @metric is DAMOS_QUOTA_NODE_MEM_{USED,FREE}_BP, @nid represents the node + * id of the target node to account the used/free memory. */ struct damos_quota_goal { enum damos_quota_goal_metric metric; -- 2.39.5