DAMON development mailing list
 help / color / mirror / Atom feed
* [RFC PATCH] mm/damon: introduce damos_sort_type for re-ordering regions list
@ 2026-08-04 10:07 Liew Rui Yan
  2026-08-04 10:23 ` sashiko-bot
  2026-08-04 13:58 ` SJ Park
  0 siblings, 2 replies; 6+ messages in thread
From: Liew Rui Yan @ 2026-08-04 10:07 UTC (permalink / raw)
  To: SJ Park; +Cc: damon, linux-mm, Liew Rui Yan

Problem
=======

A DAMOS scheme filters its target regions using an access pattern, which
is constructed with the size, the access frequency (nr_accesses), and
the age of the regions. The age here means how long the current access
pattern of a region has been maintained.

For the pageout action, the age.min of the access pattern effectively
acts as the minimum amount of time that the target regions must have been
unused.

The definition of cold memory highly depends on the devices and
workloads, and thus setting a proper default age.min (e.g., min_age of
DAMON_RECLAIM) is both important and nearly impossible to make suitable
for all devices and workloads.

Solution
========

Add a per-scheme sysfs attribute, schemes/<N>/sort_type, whose default
value is 'none'. A scheme can set it to 'score_desc', which makes the
scheme to collect the target regions and apply its action in descending
order of the regions' scores, as calculated by the ops.get_scheme_score()
callback, during the application. For a pageout scheme, the callback
returns the coldness score of each region.

Instead of modifying the region list, DAMON copies the target valid
regions into a temporary array, sorts the array in descending order of
the regions' scores, and applies the action in the sorted order.

With this, the scheme gives absolute priority to the highest-scored
region. For example, a pageout scheme with 'score_desc' reclaims the
coldest region of the target first. Users can thus keep the age.min
relatively small and let the score ordering do the precise
prioritization.

Note that regions are applied in the score order, not the address order.
Therefore, the address-based quota charge resume mechanism is not
available for such schemes. Instead, the quota is spent on the
highest-scored regions of each charge window. Applying an action
resets the age of the applied regions (except for 'stat' action), so
those regions are naturally excluded from the next window if the scheme
has a non-zero age.min. Also, when a region is split for the quota, the
age of the split-out part is preserved, and thus the highest-scored
region is continuously applied until it is fully reclaimed, even when it
is larger than the remaining quota of a single window.

Signed-off-by: Liew Rui Yan <aethernet65535@gmail.com>
---
I am currently running the corresponding benchmarks to ensure that this
does not introduce too much performance overhead, at least not on my
device.

The purpose of sending this patch is to make sure this is a right
direction.

About my device/VM
==================

CPU: AMD Ryzen 5 5600H (12 Cores)
RAM: 8GiB in VM (4GiB + 4GiB ZRAM)

I currently foresee two potential issues with thiss patch, though I
have not obtained the test results yet, so these are just guesses.

1. Excessive memory allocations and deallocations 

    The default aggr_interval is 100ms. Executing at least one
    allocation and deallocation every 100ms is very likely to cause
    unnecessary performance overhead.

    I think this issue could be resolved by having the scheme maintain
    its own buffer.

2. Performance overhead of re-ordering

    Although on my device the number of regions is not very large, and
    DAMON's default limit of 1,000 regions also helps avoid performance
    overhead, I suspect that large servers might not stick to just 1,000
    regions.

    A solution I can think of is using a Top K Min Heap, though that
    might significantly increase code complexity and reduce readability.

As a reminder, these are just my __guesses__ and do not necessarily
reflect what will happen in practice. I will send another email after
completing the benchmarks and micro-performance testing.

 include/linux/damon.h    |   6 ++
 mm/damon/core.c          | 125 ++++++++++++++++++++++++++++++++++++++-
 mm/damon/sysfs-schemes.c |  57 ++++++++++++++++++
 3 files changed, 187 insertions(+), 1 deletion(-)

diff --git a/include/linux/damon.h b/include/linux/damon.h
index 0c8b7ddef9ab..88a3f9f4a4ca 100644
--- a/include/linux/damon.h
+++ b/include/linux/damon.h
@@ -140,6 +140,11 @@ enum damos_action {
 	NR_DAMOS_ACTIONS,
 };
 
+enum damos_sort_type {
+	DAMOS_SORT_NONE,
+	DAMOS_SORT_SCORE_DESC,
+};
+
 /**
  * enum damos_quota_goal_metric - Represents the metric to be used as the goal
  *
@@ -565,6 +570,7 @@ struct damos {
 	};
 	struct damos_stat stat;
 	unsigned long max_nr_snapshots;
+	enum damos_sort_type sort_type;
 /* private: internal use only */
 	/*
 	 * number of sample intervals that should be passed before applying
diff --git a/mm/damon/core.c b/mm/damon/core.c
index 644daf5a1656..b0c52c9eabe8 100644
--- a/mm/damon/core.c
+++ b/mm/damon/core.c
@@ -15,6 +15,7 @@
 #include <linux/slab.h>
 #include <linux/string.h>
 #include <linux/string_choices.h>
+#include <linux/sort.h>
 
 /* for damon_get_folio() used by node eligible memory metrics */
 #include "ops-common.h"
@@ -705,6 +706,7 @@ struct damos *damon_new_scheme(struct damos_access_pattern *pattern,
 	INIT_LIST_HEAD(&scheme->ops_filters);
 	scheme->stat = (struct damos_stat){};
 	scheme->max_nr_snapshots = 0;
+	scheme->sort_type = DAMOS_SORT_NONE;
 	scheme->last_applied = NULL;
 	INIT_LIST_HEAD(&scheme->list);
 
@@ -1465,6 +1467,7 @@ static int damos_commit(struct damos *dst, struct damos *src)
 		return err;
 
 	dst->max_nr_snapshots = src->max_nr_snapshots;
+	dst->sort_type = src->sort_type;
 	return 0;
 }
 
@@ -2627,7 +2630,12 @@ static void damos_apply_scheme(struct damon_ctx *c, struct damon_target *t,
 		quota->total_charged_ns += timespec64_to_ns(&end) -
 			timespec64_to_ns(&begin);
 		damos_charge_quota(quota, sz, sz_applied);
-		if (damos_quota_is_full(quota, c->min_region_sz)) {
+		/*
+		 * Since it can no longer be guaranteed that the re-ordered
+		 * Region List is sorted by address. So, no record.
+		 */
+		if (s->sort_type == DAMOS_SORT_NONE &&
+			damos_quota_is_full(quota, c->min_region_sz)) {
 			quota->charge_target_from = t;
 			quota->charge_addr_from = r->ar.end;
 		}
@@ -2648,6 +2656,9 @@ static void damon_do_apply_schemes(struct damon_ctx *c,
 	damon_for_each_scheme(s, c) {
 		struct damos_quota *quota = &s->quota;
 
+		if (s->sort_type != DAMOS_SORT_NONE)
+			continue;
+
 		if (time_before(c->passed_sample_intervals, s->next_apply_sis))
 			continue;
 
@@ -2673,6 +2684,107 @@ static void damon_do_apply_schemes(struct damon_ctx *c,
 	}
 }
 
+struct damos_sort_priv {
+	struct damon_ctx *c;
+	struct damos *s;
+};
+
+static int damos_sort_score_desc_cmp(const void *a, const void *b,
+		const void *priv)
+{
+	struct damon_region *ra = *(struct damon_region **)a;
+	struct damon_region *rb = *(struct damon_region **)b;
+	const struct damos_sort_priv *p = priv;
+	int score_a = p->c->ops.get_scheme_score(p->c, ra, p->s);
+	int score_b = p->c->ops.get_scheme_score(p->c, rb, p->s);
+
+	return cmp_int(score_b, score_a);
+}
+
+static void damos_apply_sorted_scheme(struct damon_ctx *c,
+		struct damon_target *t, struct damos *s)
+{
+	struct damon_region **arr;
+	struct damon_region *r;
+	struct damos_quota *quota = &s->quota;
+	struct damos_sort_priv priv = { .c = c, .s = s };
+	unsigned long nr = 0, i = 0;
+
+	if (!c->ops.get_scheme_score)
+		return;
+	/* Avoid unnecessary kvmalloc_array() */
+	if (damos_quota_is_full(quota, c->min_region_sz))
+		return;
+
+	damon_for_each_region(r, t) {
+		if (__damos_valid_target(r, s, c))
+			nr++;
+	}
+	if (nr == 0)
+		return;
+	if (nr == 1)
+		goto single_valid_region;
+
+	arr = kvmalloc_array(nr, sizeof(*arr), GFP_KERNEL);
+
+	if (!arr)
+		return;
+
+	damon_for_each_region(r, t) {
+		if (__damos_valid_target(r, s, c))
+			arr[i++] = r;
+	}
+
+	sort_r_nonatomic(arr, nr, sizeof(*arr), damos_sort_score_desc_cmp, NULL, &priv);
+
+	for (i = 0; i < nr; i++) {
+		r = arr[i];
+
+		/* Check the quota */
+		if (damos_quota_is_full(quota, c->min_region_sz))
+			break;
+
+		if (s->max_nr_snapshots &&
+				s->max_nr_snapshots <= s->stat.nr_snapshots)
+			continue;
+
+		if (damos_valid_target(c, r, s)) {
+			damos_apply_scheme(c, t, r, s);
+		} else {
+			/*
+			 * There is no need to continue because the score is
+			 * already lower than quota.min_score.
+			 */
+			break;
+		}
+
+		if (i == nr - 1)
+			s->stat.nr_snapshots++;
+	}
+
+	kvfree(arr);
+	return;
+
+single_valid_region:
+	damon_for_each_region(r, t) {
+		if (__damos_valid_target(r, s, c))
+			break;
+	}
+
+	/* Check the quota */
+	if (damos_quota_is_full(quota, c->min_region_sz))
+		return;
+
+	if (s->max_nr_snapshots &&
+			s->max_nr_snapshots <= s->stat.nr_snapshots)
+		return;
+
+	if (damos_valid_target(c, r, s))
+		damos_apply_scheme(c, t, r, s);
+
+	s->stat.nr_snapshots++;
+}
+
 /*
  * damos_apply_target() - Apply DAMOS schemes to a given target.
  * @c:			monitoring context to apply its DAMOS schemes to..
@@ -2695,6 +2807,17 @@ static void damos_apply_target(struct damon_ctx *c, struct damon_target *t,
 		unsigned long max_region_sz)
 {
 	struct damon_region *r;
+	struct damos *s;
+
+	damon_for_each_scheme(s, c) {
+		if (s->sort_type == DAMOS_SORT_NONE)
+			continue;
+		if (!s->wmarks.activated)
+			continue;
+		if (time_before(c->passed_sample_intervals, s->next_apply_sis))
+			continue;
+		damos_apply_sorted_scheme(c, t, s);
+	}
 
 	damon_for_each_region(r, t) {
 		struct damon_region *prev_r;
diff --git a/mm/damon/sysfs-schemes.c b/mm/damon/sysfs-schemes.c
index 32f495a96b17..1fcbc39b5cd6 100644
--- a/mm/damon/sysfs-schemes.c
+++ b/mm/damon/sysfs-schemes.c
@@ -2261,6 +2261,7 @@ struct damon_sysfs_scheme {
 	struct damon_sysfs_scheme_regions *tried_regions;
 	int target_nid;
 	struct damos_sysfs_dests *dests;
+	enum damos_sort_type sort_type;
 };
 
 struct damos_sysfs_action_name {
@@ -2315,6 +2316,20 @@ static struct damos_sysfs_action_name damos_sysfs_action_names[] = {
 	},
 };
 
+static struct damos_sysfs_sort_type_name {
+	enum damos_sort_type sort_type;
+	char *name;
+} damos_sysfs_sort_type_names[] = {
+	{
+		.sort_type = DAMOS_SORT_NONE,
+		.name = "none",
+	},
+	{
+		.sort_type = DAMOS_SORT_SCORE_DESC,
+		.name = "score_desc",
+	},
+};
+
 static struct damon_sysfs_scheme *damon_sysfs_scheme_alloc(
 		enum damos_action action, unsigned long apply_interval_us)
 {
@@ -2326,6 +2341,7 @@ static struct damon_sysfs_scheme *damon_sysfs_scheme_alloc(
 	scheme->action = action;
 	scheme->apply_interval_us = apply_interval_us;
 	scheme->target_nid = NUMA_NO_NODE;
+	scheme->sort_type = DAMOS_SORT_NONE;
 	return scheme;
 }
 
@@ -2645,6 +2661,42 @@ static ssize_t target_nid_store(struct kobject *kobj,
 	return err ? err : count;
 }
 
+static ssize_t sort_type_show(struct kobject *kobj, struct kobj_attribute *attr,
+		char *buf)
+{
+	struct damon_sysfs_scheme *scheme = container_of(kobj,
+			struct damon_sysfs_scheme, kobj);
+	int i;
+
+	for (i = 0; i < ARRAY_SIZE(damos_sysfs_sort_type_names); i++) {
+		struct damos_sysfs_sort_type_name *type_name;
+
+		type_name = &damos_sysfs_sort_type_names[i];
+		if (type_name->sort_type == scheme->sort_type)
+			return sysfs_emit(buf, "%s\n", type_name->name);
+	}
+	return -EINVAL;
+}
+
+static ssize_t sort_type_store(struct kobject *kobj, struct kobj_attribute *attr,
+		const char *buf, size_t count)
+{
+	struct damon_sysfs_scheme *scheme = container_of(kobj,
+			struct damon_sysfs_scheme, kobj);
+	int i;
+
+	for (i = 0; i < ARRAY_SIZE(damos_sysfs_sort_type_names); i++) {
+		struct damos_sysfs_sort_type_name *type_name;
+
+		type_name = &damos_sysfs_sort_type_names[i];
+		if (sysfs_streq(buf, type_name->name)) {
+			scheme->sort_type = type_name->sort_type;
+			return count;
+		}
+	}
+	return -EINVAL;
+}
+
 static void damon_sysfs_scheme_release(struct kobject *kobj)
 {
 	kfree(container_of(kobj, struct damon_sysfs_scheme, kobj));
@@ -2659,10 +2711,14 @@ static struct kobj_attribute damon_sysfs_scheme_apply_interval_us_attr =
 static struct kobj_attribute damon_sysfs_scheme_target_nid_attr =
 		__ATTR_RW_MODE(target_nid, 0600);
 
+static struct kobj_attribute damon_sysfs_scheme_sort_type_attr =
+		__ATTR_RW_MODE(sort_type, 0600);
+
 static struct attribute *damon_sysfs_scheme_attrs[] = {
 	&damon_sysfs_scheme_action_attr.attr,
 	&damon_sysfs_scheme_apply_interval_us_attr.attr,
 	&damon_sysfs_scheme_target_nid_attr.attr,
+	&damon_sysfs_scheme_sort_type_attr.attr,
 	NULL,
 };
 ATTRIBUTE_GROUPS(damon_sysfs_scheme);
@@ -3038,6 +3094,7 @@ static struct damos *damon_sysfs_mk_scheme(
 		return NULL;
 	}
 	scheme->max_nr_snapshots = sysfs_scheme->stats->max_nr_snapshots;
+	scheme->sort_type = sysfs_scheme->sort_type;
 	return scheme;
 }
 
-- 
2.55.0


^ permalink raw reply related	[flat|nested] 6+ messages in thread

end of thread, other threads:[~2026-08-05 13:51 UTC | newest]

Thread overview: 6+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2026-08-04 10:07 [RFC PATCH] mm/damon: introduce damos_sort_type for re-ordering regions list Liew Rui Yan
2026-08-04 10:23 ` sashiko-bot
2026-08-04 12:05   ` Liew Rui Yan
2026-08-04 13:58 ` SJ Park
2026-08-05  8:12   ` Liew Rui Yan
2026-08-05 13:51     ` SJ Park

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox