mm/damon/reclaim.rst

1 .. SPDX-License-Identifier: GPL-2.0
4 DAMON-based Reclamation
7 DAMON-based Reclamation (DAMON_RECLAIM) is a static kernel module that aimed to
9 It doesn't aim to replace the LRU-list based page_granularity reclamation, but
15 On general memory over-committed systems, proactively reclaiming cold pages
20 Free Pages Reporting [3]_ based memory over-commit virtualization systems are
24 guests could be not so memory-frugal, mainly because some kernel subsystems and
25 user-space applications are designed to use as much memory as available.  Then,
54 -------
60 no real monitoring and reclamation due to the watermarks-based activation
64 -------------
70 of parametrs except ``enabled`` again.  Once the re-reading is done, this
72 re-reading, DAMON_RECLAIM will be disabled.
75 -------
85 --------
94 10 ms by default.
97 --------
109 -----------------------
121 ---------------
127 -----------
136 ----------
141 the low watermark, DAMON_RECLAIM becomes active, so starts the monitoring and
145 ----------
151 watermarks.  In the case, the system falls back to the LRU-list based page
155 ---------------
163 -------------
171 --------------
176 monitoring.  This can be used to set lower-bound of the monitoring quality.
181 --------------
186 monitoring.  This can be used to set upper-bound of the monitoring overhead.
191 --------------------
200 ------------------
209 ---------
218 -----------
223 -1.
226 ------------------------
231 ---------------------------
236 --------------------
241 -----------------------
246 ----------------
260 do nothing again, so that we can fall back to the LRU-list based page
264     # echo 30000000 > min_age
265     # echo $((1 * 1024 * 1024 * 1024)) > quota_sz
266     # echo 1000 > quota_reset_interval_ms
267     # echo 500 > wmarks_high
268     # echo 400 > wmarks_mid
269     # echo 200 > wmarks_low
270     # echo Y > enabled