Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
Docs/mm/damon/design: document DAMOS_QUOTA_NODE_MEMCG_{USED,FREE}_BP
Update design doc for the newly added two DAMOS quota auto-tuning target
goal metrics, DAMOS_QUOTA_NODE_MEMCG_{USED,FREE}_BP.
Link: https://lkml.kernel.org/r/20251017212706.183502-9-sj@kernel.org
Signed-off-by: SeongJae Park <sj@kernel.org>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
authored by
SeongJae Park
and committed by
Andrew Morton
4cc00d41
c2fbf2da
+14
-5
+14
-5
Documentation/mm/damon/design.rst
+14
-5
Documentation/mm/damon/design.rst
···
564
564
is under achieving the goal, DAMOS automatically increases the quota. If DAMOS
565
565
is over achieving the goal, it decreases the quota.
566
566
567
-
The goal can be specified with four parameters, namely ``target_metric``,
568
-
``target_value``, ``current_value`` and ``nid``. The auto-tuning mechanism
569
-
tries to make ``current_value`` of ``target_metric`` be same to
567
+
The goal can be specified with five parameters, namely ``target_metric``,
568
+
``target_value``, ``current_value``, ``nid`` and ``path``. The auto-tuning
569
+
mechanism tries to make ``current_value`` of ``target_metric`` be same to
570
570
``target_value``.
571
571
572
572
- ``user_input``: User-provided value. Users could use any metric that they
···
581
581
set by users at the initial time. In other words, DAMOS does self-feedback.
582
582
- ``node_mem_used_bp``: Specific NUMA node's used memory ratio in bp (1/10,000).
583
583
- ``node_mem_free_bp``: Specific NUMA node's free memory ratio in bp (1/10,000).
584
+
- ``node_memcg_used_bp``: Specific cgroup's node used memory ratio for a
585
+
specific NUMA node, in bp (1/10,000).
586
+
- ``node_memcg_free_bp``: Specific cgroup's node unused memory ratio for a
587
+
specific NUMA node, in bp (1/10,000).
584
588
585
-
``nid`` is optionally required for only ``node_mem_used_bp`` and
586
-
``node_mem_free_bp`` to point the specific NUMA node.
589
+
``nid`` is optionally required for only ``node_mem_used_bp``,
590
+
``node_mem_free_bp``, ``node_memcg_used_bp`` and ``node_memcg_free_bp`` to
591
+
point the specific NUMA node.
592
+
593
+
``path`` is optionally required for only ``node_memcg_used_bp`` and
594
+
``node_memcg_free_bp`` to point the path to the cgroup. The value should be
595
+
the path of the memory cgroup from the cgroups mount point.
587
596
588
597
To know how user-space can set the tuning goal metric, the target value, and/or
589
598
the current value via :ref:`DAMON sysfs interface <sysfs_interface>`, refer to