linux.git/include/linux/damon.h, branch v7.3-rc2

mm/damon: update outdated comment about DAMOS filter handling

2026-08-07T01:57:22+00:00

The kernel-doc comment above enum damos_filter_type states that only the
anon and memcg type filters are handled by damon_operations (and therefore
accounted as 'tried'), and that DAMON_OPS_VADDR and DAMON_OPS_FVADDR do
not support those two filter types.

Neither is accurate anymore.  damos_filter_for_ops() routes every filter
type except ADDR and TARGET to the operations layer, and the VADDR and
FVADDR operations (the latter being a copy of the former) handle all of
those types through damos_folio_filter_match() / damos_va_filter_out(). 
Update the comment to match the code.

Link: https://lore.kernel.org/20260721140011.269802-1-sj@kernel.org
Signed-off-by: Song Hu 
Reviewed-by: SJ Park 
Signed-off-by: SJ Park 
Signed-off-by: Andrew Morton

mm/damon/core: hide core-private damon_ctx fields

2026-08-07T01:57:07+00:00

'ops', 'probes', 'adaptive_targets', 'schemes', and 'rnd_state' fields of
damon_ctx are intended to be used by only the DAMON core layer.  However,
those are mistakenly not marked as private.  Mark as private.

Link: https://lore.kernel.org/20260714143544.101305-11-sj@kernel.org
Signed-off-by: SJ Park 
Signed-off-by: Andrew Morton

mm/damon/core: hide private damon_probe fields

2026-08-07T01:57:07+00:00

'filters' and 'list' fields of damon_probe are intended to be used by only
the DAMON core layer.  However, those are mistakenly not marked as
private.  Mark as private.

Link: https://lore.kernel.org/20260714143544.101305-9-sj@kernel.org
Signed-off-by: SJ Park 
Signed-off-by: Andrew Morton

mm/damon/core: hide private damon_filter fields

2026-08-07T01:57:06+00:00

damon_filter->list is intended to be used by only the DAMON core layer. 
However, it is mistakenly not marked as private.  Mark as private.

Link: https://lore.kernel.org/20260714143544.101305-8-sj@kernel.org
Signed-off-by: SJ Park 
Signed-off-by: Andrew Morton

mm/damon/core: hide private damos fields

2026-08-07T01:57:06+00:00

'core_filters', 'ops_filters', 'last_applied' and 'list' fields of damos
are intended to be used by only the DAMON core layer.  However, those are
mistakenly not marked as private.  Mark as private.

Link: https://lore.kernel.org/20260714143544.101305-7-sj@kernel.org
Signed-off-by: SJ Park 
Signed-off-by: Andrew Morton

mm/damon/core: hide private damos_filter fields

2026-08-07T01:57:06+00:00

damos_filter->list is intended to be used by only the DAMON core layer. 
However, it is mistakenly not marked as private.  Mark as private.

Link: https://lore.kernel.org/20260714143544.101305-6-sj@kernel.org
Signed-off-by: SJ Park 
Signed-off-by: Andrew Morton

mm/damon/core: hide private damos_quota fields

2026-08-07T01:57:05+00:00

damos_quota->goals is intended to be used by only the DAMON core layer. 
But it is mistakenly not marked as private.  Mark as private.

Link: https://lore.kernel.org/20260714143544.101305-5-sj@kernel.org
Signed-off-by: SJ Park 
Signed-off-by: Andrew Morton

mm/damon/core: hide private damos_quota_goal fields

2026-08-07T01:57:05+00:00

'last_psi_total' and 'list' of damos_quota_goal are intended to be used by
only the DAMON core layer.  Those are mistakenly not marked as private,
though.  Mark as private.

Link: https://lore.kernel.org/20260714143544.101305-4-sj@kernel.org
Signed-off-by: SJ Park 
Signed-off-by: Andrew Morton

mm/damon/core: hide private damon_target fields

2026-08-07T01:57:05+00:00

'nr_regions', 'regions_list' and 'list' fields of damon_target are
intended to be used by only the DAMON core layer.  Those are mistakenly
not marked as private.  Mark as private.

Link: https://lore.kernel.org/20260714143544.101305-3-sj@kernel.org
Signed-off-by: SJ Park 
Signed-off-by: Andrew Morton

mm/damon/core: hide private damon_region fields

2026-08-07T01:57:05+00:00

Patch series "mm/damon/core: hide core-private struct fields".

DAMON core structs hide core-private fields using 'private:' comment tags.
It is incomplete and inconsistent.  The linked list heads in a few
structs, for example, are intended to be hidden, and always be used using
the wrapper macros like damon_for_each_region().  But those were
mistakenly marked as non-private.  A few core layer-only fields were also
mistakenly added as non-private.

This only encourages callers to directly use the private fields.  It is
easy to make mistakes, and difficult to control.  Mark all such DAMON core
struct fields as private.

Patches 1-8 mark the private fields for damon_region, damon_target,
damos_quota_goal, damos_quota, damos_filter, damos, damon_filter and
damon_probe, respectively.  Patch 9 removes DAMON_SYSFS's direct access to
core-private field, damon_ctx->ops.  Finally patch 10 mark the private
fields for damon_ctx.


This patch (of 10):

damon_region->list is intended to be used by only the DAMON core layer. 
But it is mistakenly not marked as private.  Hide it from the callers by
marking it private.

Link: https://lore.kernel.org/20260714143544.101305-1-sj@kernel.org
Link: https://lore.kernel.org/20260714143544.101305-2-sj@kernel.org
Signed-off-by: SJ Park 
Signed-off-by: Andrew Morton