DAMON development mailing list
 help / color / mirror / Atom feed
From: SJ Park <sj@kernel.org>
Cc: SJ Park <sj@kernel.org>,
	damon@lists.linux.dev, linux-kernel@vger.kernel.org,
	linux-mm@kvack.org
Subject: [RFC PATCH v2 01/27] mm/damon/api: introduce struct damon_report
Date: Tue, 17 Nov 2026 18:21:56 -0800	[thread overview]
Message-ID: <20261118022225.100659-2-sj@kernel.org> (raw)
In-Reply-To: <20261118022225.100659-1-sj@kernel.org>

Define a struct for data attribute report.  The struct provides public
fields for the type and the memory address range.  The type field
represents the type of the report itself.  The address range is for the
memory of the reporting data.  Data attribute producers can format their
report using those fields.

It also has a private field representing when the report is submitted.

Signed-off-by: SJ Park <sj@kernel.org>
---
 include/linux/damon.h | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/include/linux/damon.h b/include/linux/damon.h
index 06bd92981af21..cac1329397a4f 100644
--- a/include/linux/damon.h
+++ b/include/linux/damon.h
@@ -751,6 +751,27 @@ struct damon_intervals_goal {
 	unsigned long max_sample_us;
 };
 
+/**
+ * enum damon_report_type - Type of &struct damon_report.
+ */
+enum damon_report_type {
+	NR_DAMON_REPORT_TYPES,
+};
+
+/**
+ * struct damon_report - Data attribute report information.
+ *
+ * @type:	Type of the report.
+ * @addr_range:	The address range of the memory to report for.
+ */
+struct damon_report {
+	enum damon_report_type type;
+	struct damon_addr_range addr_range;
+/* private: */
+	/* when this report is generated */
+	unsigned long jiffies;
+};
+
 /**
  * enum damon_prep_action - DAMON probing preparation action.
  *
-- 
2.47.3

  reply	other threads:[~2026-11-18  2:22 UTC|newest]

Thread overview: 55+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2026-11-18  2:21 [RFC PATCH v2 00/27] mm/damon: let users report their data attribute findings SJ Park
2026-11-18  2:21 ` SJ Park [this message]
2026-11-18  2:33   ` [RFC PATCH v2 01/27] mm/damon/api: introduce struct damon_report sashiko-bot
2026-11-18  2:21 ` [RFC PATCH v2 02/27] mm/damon/core: implement data attribute report queue SJ Park
2026-11-18  2:26   ` sashiko-bot
2026-11-18  2:21 ` [RFC PATCH v2 03/27] mm/damon/core: introduce damon_submit_report() SJ Park
2026-11-18  2:36   ` sashiko-bot
2026-11-18  2:21 ` [RFC PATCH v2 04/27] mm/damon/sysfs: add admin/reports/ directory SJ Park
2026-11-18  2:26   ` sashiko-bot
2026-11-18  2:22 ` [RFC PATCH v2 05/27] mm/damon/sysfs: add reports/producers/ directory SJ Park
2026-11-18  2:27   ` sashiko-bot
2026-11-18  2:22 ` [RFC PATCH v2 06/27] mm/damon/sysfs: add producers/nr_producers file SJ Park
2026-11-18  2:27   ` sashiko-bot
2026-11-18  2:22 ` [RFC PATCH v2 07/27] mm/damon/sysfs: implement report producer directory SJ Park
2026-11-18  2:26   ` sashiko-bot
2026-11-18  2:22 ` [RFC PATCH v2 08/27] mm/damon/sysfs: implement report producer type and state files SJ Park
2026-11-18  2:33   ` sashiko-bot
2026-11-18  2:22 ` [RFC PATCH v2 09/27] Docs/mm/damon/design: update for report system SJ Park
2026-11-18  2:34   ` sashiko-bot
2026-11-18  2:22 ` [RFC PATCH v2 10/27] Docs/admin-guide/mm/damon/usage: update for report producer sysfs SJ Park
2026-11-18  2:27   ` sashiko-bot
2026-11-18  2:22 ` [RFC PATCH v2 11/27] Docs/ABI/damon: update for report producer sysfs files SJ Park
2026-11-18  2:25   ` sashiko-bot
2026-11-18  2:22 ` [RFC PATCH v2 12/27] mm/damon/core: introduce DAMON_FILTER_TYPE_REPORT_MADE SJ Park
2026-11-18  2:30   ` sashiko-bot
2026-11-18  2:22 ` [RFC PATCH v2 13/27] mm/damon/core: introduce damon_report_exist() SJ Park
2026-11-18  2:27   ` sashiko-bot
2026-11-18  2:22 ` [RFC PATCH v2 14/27] mm/damon/paddr: support REPORT_MADE type probe filter SJ Park
2026-11-18  2:28   ` sashiko-bot
2026-11-18  2:22 ` [RFC PATCH v2 15/27] mm/damon/sysfs: add filter_report_type file under probe filter directory SJ Park
2026-11-18  2:27   ` sashiko-bot
2026-11-18  2:22 ` [RFC PATCH v2 16/27] mm/damon/sysfs: support REPORT_MADE type probe filter setup SJ Park
2026-11-18  2:27   ` sashiko-bot
2026-11-18  2:22 ` [RFC PATCH v2 17/27] Docs/mm/damon/design: update for report_made probe filter type SJ Park
2026-11-18  2:26   ` sashiko-bot
2026-11-18  2:22 ` [RFC PATCH v2 18/27] Docs/admin-guide/mm/damon/usage: update for REPORT_MADE probe filter SJ Park
2026-11-18  2:28   ` sashiko-bot
2026-11-18  2:22 ` [RFC PATCH v2 19/27] Docs/ABI/damon: " SJ Park
2026-11-18  2:28   ` sashiko-bot
2026-11-18  2:22 ` [RFC PATCH v2 20/27] mm/damon/api: introduce user_report report type SJ Park
2026-11-18  2:29   ` sashiko-bot
2026-11-18  2:22 ` [RFC PATCH v2 21/27] mm/damon/sysfs: add user_report support for report type input SJ Park
2026-11-18  2:28   ` sashiko-bot
2026-11-18  2:22 ` [RFC PATCH v2 22/27] mm/damon/sysfs: implement report producer addr_{start,end} files SJ Park
2026-11-18  2:29   ` sashiko-bot
2026-11-18  2:22 ` [RFC PATCH v2 23/27] mm/damon/sysfs: implement submit command for report producer SJ Park
2026-11-18  2:31   ` sashiko-bot
2026-11-18  2:22 ` [RFC PATCH v2 24/27] selftests/damon/sysfs.sh: add basic tests for admin/reports/ SJ Park
2026-11-18  2:30   ` sashiko-bot
2026-11-18  2:22 ` [RFC PATCH v2 25/27] Docs/mm/damon/design: update for user report support SJ Park
2026-11-18  2:29   ` sashiko-bot
2026-11-18  2:22 ` [RFC PATCH v2 26/27] Docs/admin-guide/mm/damon/usage: update for user_report " SJ Park
2026-11-18  2:30   ` sashiko-bot
2026-11-18  2:22 ` [RFC PATCH v2 27/27] Docs/ABI/damon: " SJ Park
2026-11-18  2:29   ` sashiko-bot

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20261118022225.100659-2-sj@kernel.org \
    --to=sj@kernel.org \
    --cc=damon@lists.linux.dev \
    --cc=linux-kernel@vger.kernel.org \
    --cc=linux-mm@kvack.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox