]> git.ipfire.org Git - thirdparty/kernel/linux.git/commitdiff
Docs/ABI/damon: document schemes dests directory
authorSeongJae Park <sj@kernel.org>
Wed, 9 Jul 2025 00:59:35 +0000 (19:59 -0500)
committerAndrew Morton <akpm@linux-foundation.org>
Sun, 20 Jul 2025 01:59:49 +0000 (18:59 -0700)
Document the new DAMOS action destinations sysfs directories on ABI doc.

Link: https://lkml.kernel.org/r/20250709005952.17776-6-bijan311@gmail.com
Signed-off-by: SeongJae Park <sj@kernel.org>
Cc: Bijan Tabatabai <bijantabatab@micron.com>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: Ravi Shankar Jonnalagadda <ravis.opensrc@micron.com>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
Documentation/ABI/testing/sysfs-kernel-mm-damon

index 5697ab154c1f104a55bc016baca30463e97dd5f2..e98974dfac7a80a5d2985019a3a398945cf51063 100644 (file)
@@ -431,6 +431,28 @@ Description:       Directory for DAMON operations set layer-handled DAMOS filters.
                /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters
                directory.
 
+What:          /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/dests/nr_dests
+Date:          Jul 2025
+Contact:       SeongJae Park <sj@kernel.org>
+Description:   Writing a number 'N' to this file creates the number of
+               directories for setting action destinations of the scheme named
+               '0' to 'N-1' under the dests/ directory.
+
+What:          /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/dests/<D>/id
+Date:          Jul 2025
+Contact:       SeongJae Park <sj@kernel.org>
+Description:   Writing to and reading from this file sets and gets the id of
+               the DAMOS action destination.  For DAMOS_MIGRATE_{HOT,COLD}
+               actions, the destination node's node id can be written and
+               read.
+
+What:          /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/dests/<D>/weight
+Date:          Jul 2025
+Contact:       SeongJae Park <sj@kernel.org>
+Description:   Writing to and reading from this file sets and gets the weight
+               of the DAMOS action destination to select as the destination of
+               each action among the destinations.
+
 What:          /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/stats/nr_tried
 Date:          Mar 2022
 Contact:       SeongJae Park <sj@kernel.org>