From patchwork Tue Jan 10 19:03:53 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 13095550 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 6D5A3C678D5 for ; Tue, 10 Jan 2023 19:04:12 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 8C3D38E0003; Tue, 10 Jan 2023 14:04:11 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 7FE43900002; Tue, 10 Jan 2023 14:04:11 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 5DB9F8E0005; Tue, 10 Jan 2023 14:04:11 -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 4F1BC8E0003 for ; Tue, 10 Jan 2023 14:04:11 -0500 (EST) Received: from smtpin02.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay04.hostedemail.com (Postfix) with ESMTP id 1BB8D1A1E78 for ; Tue, 10 Jan 2023 19:04:11 +0000 (UTC) X-FDA: 80339814702.02.72F9417 Received: from ams.source.kernel.org (ams.source.kernel.org [145.40.68.75]) by imf03.hostedemail.com (Postfix) with ESMTP id 5F41120057 for ; Tue, 10 Jan 2023 19:04:08 +0000 (UTC) Authentication-Results: imf03.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=fCl8S7Yi; spf=pass (imf03.hostedemail.com: domain of sj@kernel.org designates 145.40.68.75 as permitted sender) smtp.mailfrom=sj@kernel.org; dmarc=pass (policy=none) header.from=kernel.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1673377448; 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=3DVEy/H+g5xxOxDaNlg5cWLZhq40eZdLgDfmf+UPHks=; b=xbtrjjceKliZjiL2usMs331QueJ6Lz3+MgO6DLmg0/8eFB6yiVCb+A+JWeStnjrbHPasyw n52ExO4j8+RPXgo6fm+XvRcuiO4U8GWymPgfufMxvhPWm5eoCksXnn8YshbO59DaOEyoVr uJtQnqEpxeKAxYjE6Z5cNgo88kLzjfY= ARC-Authentication-Results: i=1; imf03.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=fCl8S7Yi; spf=pass (imf03.hostedemail.com: domain of sj@kernel.org designates 145.40.68.75 as permitted sender) smtp.mailfrom=sj@kernel.org; dmarc=pass (policy=none) header.from=kernel.org ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1673377448; a=rsa-sha256; cv=none; b=f3PpxpfVGRfIK7mduuh48CCgZILR0+9g4NkpN1l5JLYtHiKfJCvjtyP3+gA4TxRzZtsQ8h bS0g1cnOxNdPVOcE5XTPGRYWTgTdPjG2gonU1l5nOtnFC2X+J9ePP6jXOhR0PKZroLMt4e a0SOJsVXHXvhj6sOHB5QpGuQsiz2l6o= Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ams.source.kernel.org (Postfix) with ESMTPS id 56AAEB81975; Tue, 10 Jan 2023 19:04:06 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id AB108C433D2; Tue, 10 Jan 2023 19:04:04 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1673377445; bh=EpuEVUL614S47vXoslv07ySnDH61IdNVsBrU1EkLty8=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=fCl8S7YiAsYSjVYQ6JjpL33E5Zdyh0Drih0OrdQyMBev/agRdKUdaHNWOrGbsRJsk CUm9xv0Q1qyvDy/JbGUNQAH4T2SCwyC0lwrr3By+XE5/gPxPZUEJTGvN8p9MNiYoUH fJNRL+cOlBex8DtmAvlIcioI4YLkXREUsKisYvBQRXNjsHzh6JIaPkyi0DG+RCkTkY BEggkVrMC5MbN75tGE5AjEaBQqvdq+bYZEszEMZhwLR2sFFK/im+NdyEMMbLFCwESC lsHWX7EzszK4qUGrr0DNzX1R9gXbytMa+c88X9+QFYpxaCrUt9mwFUlVLDKC/1LoiL p5PeAAxRCMc9g== From: SeongJae Park To: Andrew Morton Cc: SeongJae Park , damon@lists.linux.dev, linux-mm@kvack.org, linux-kernel@vger.kernel.org Subject: [PATCH 1/8] mm/damon/core: update kernel-doc comments for DAMOS action supports of each DAMON operations set Date: Tue, 10 Jan 2023 19:03:53 +0000 Message-Id: <20230110190400.119388-2-sj@kernel.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20230110190400.119388-1-sj@kernel.org> References: <20230110190400.119388-1-sj@kernel.org> MIME-Version: 1.0 X-Rspamd-Server: rspam07 X-Rspamd-Queue-Id: 5F41120057 X-Rspam-User: X-Stat-Signature: 6rowxxyywhr4zhpgq45833aprji5sqco X-HE-Tag: 1673377448-788204 X-HE-Meta: U2FsdGVkX19N2dMIyIBJMXF5ZTKgPkGBOq+R8GqYv2pClUUW8N9gH0SrqXqFLrBz3YJ2AM4XEJa0ileQpj+Z++IpFVaAqUpUGpBOl9WGDbJ0oNcGq9/3f+f+f5klO3gAs1ZF1R7vj7Sx9P/dtnHFripJmwNUe72cVRLmzy+lhLMHreCt0Cm9/53ce4V+ttBwN1HUksE8y8CijDOhvo2wTvcZKFkac+NDenhSGjvvWwvN1jXLCAi8kJ3cb3JYirKxOA64I2Wg1Yj70y8j6GLHT1Wk6yjKsI1/7h6qt1l4EM4QfxnZ+EQnwC0Q1saDP38PMROeM90xbXK5zUEH+YI1K+5KU7T730IuhIA23LbkZwWEddbtdYbrZ5gRugW0zmaB/h3jkmMdcnNgxKZcIZrrEZDOkoL49bqyQafQ+i6DgECPIC1dqbtD6fR9D0FrwjZ1rtW6ATwDjr/OeEl7kT1h1T8J7JpecoAU9VuGlU/9+Gd6TrY4xLfJQ38/G0WB3wIeEMqhhnZlNWTHpLE+H3oLCF7jeINfTGaGq2QUYyVy22PI3oB8RWq0QuUKd8bbyvWaLK6mvQPpcne5JWBepWqlmt5ukKdc4CMU/SyWb5XhF2kCkFmwpCMUZ068LVfAivDtNFI+W81k6jqV92QjUSAFXHA8p2Pj380zuorWVyRquVp8Vr9Xv9u1F6hFmseZjtxC/JgMHuq2Uk9Q9By346MQhfM2lMSH8dM/7iMLPOt3lE5pA5vM0r+r914JRdiInXf3rs/iDZ+BBRYUVmUjx4fUWCw2RoanBOTNLC6OGlyojLC1jR38QGjg9+qOVWDovdUldzJHYg6IXQhpHG7Gd//WOo9KvXvYSi3Xb1kuH/tLEUcJ1GtikVT5XpjTVCSZBOubSOqMs8oazWlF5GYHYEk9FeXpZFo5Nay/vBRG/3X9gE9ODmxdfHpeVN5K5ym14JXPj/FJaf8BOBQzROy6HMn LaH07V4Y IltQ4ecS18Mj5JCWKCbk0K4d+gtKhPg/wJwGE9z0LvlmEfxQNKriD2GGqW1a26Yb2x/h4 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: Supports of each DAMOS action are up to DAMON operations set implementation in use, but not well mentioned on the kernel-doc comments. Add the comment. Signed-off-by: SeongJae Park --- include/linux/damon.h | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/include/linux/damon.h b/include/linux/damon.h index 7907918ad2e0..3fa96d7c9fe4 100644 --- a/include/linux/damon.h +++ b/include/linux/damon.h @@ -91,6 +91,12 @@ struct damon_target { * @DAMOS_LRU_DEPRIO: Deprioritize the region on its LRU lists. * @DAMOS_STAT: Do nothing but count the stat. * @NR_DAMOS_ACTIONS: Total number of DAMOS actions + * + * The support of each action is up to running &struct damon_operations. + * &enum DAMON_OPS_VADDR and &enum DAMON_OPS_FVADDR supports all actions except + * &enum DAMOS_LRU_PRIO and &enum DAMOS_LRU_DEPRIO. &enum DAMON_OPS_PADDR + * supports only &enum DAMOS_PAGEOUT, &enum DAMOS_LRU_PRIO, &enum + * DAMOS_LRU_DEPRIO, and &DAMOS_STAT. */ enum damos_action { DAMOS_WILLNEED,