Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
Docs/mm/damon/design: document the goal-based quota tuner selections
Update the design document for the newly added goal-based quota tuner
selection feature.
Link: https://lkml.kernel.org/r/20260310010529.91162-6-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
5a242f9d
e9a19cc8
+12
+12
Documentation/mm/damon/design.rst
+12
Documentation/mm/damon/design.rst
···
566
566
is under achieving the goal, DAMOS automatically increases the quota. If DAMOS
567
567
is over achieving the goal, it decreases the quota.
568
568
569
+
There are two such tuning algorithms that users can select as they need.
570
+
571
+
- ``consist``: A proportional feedback loop based algorithm. Tries to find an
572
+
optimum quota that should be consistently kept, to keep achieving the goal.
573
+
Useful for kernel-only operation on dynamic and long-running environments.
574
+
This is the default selection. If unsure, use this.
575
+
- ``temporal``: More straightforward algorithm. Tries to achieve the goal as
576
+
fast as possible, using maximum allowed quota, but only for a temporal short
577
+
time. When the quota is under-achieved, this algorithm keeps tuning quota to
578
+
a maximum allowed one. Once the quota is [over]-achieved, this sets the
579
+
quota zero. Useful for deterministic control required environments.
580
+
569
581
The goal can be specified with five parameters, namely ``target_metric``,
570
582
``target_value``, ``current_value``, ``nid`` and ``path``. The auto-tuning
571
583
mechanism tries to make ``current_value`` of ``target_metric`` be same to