Commit 2d89957c authored by SeongJae Park's avatar SeongJae Park Committed by Andrew Morton

Docs/mm/damon: move monitoring target regions setup detail from the usage to the design document

Design doc is aimed to have all concept level details, while the usage doc
is focused on only how the features can be used.  Some details about
monitoring target regions construction is on the usage doc.  Move the
details about the monitoring target regions construction differences for
DAMON operations set from the usage to the design doc.

Link: https://lkml.kernel.org/r/20240217005842.87348-5-sj@kernel.orgSigned-off-by: default avatarSeongJae Park <sj@kernel.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Signed-off-by: default avatarAndrew Morton <akpm@linux-foundation.org>
parent 669971b4
...@@ -242,17 +242,11 @@ process to the ``pid_target`` file. ...@@ -242,17 +242,11 @@ process to the ``pid_target`` file.
targets/<N>/regions targets/<N>/regions
------------------- -------------------
When ``vaddr`` monitoring operations set is being used (``vaddr`` is written to In case of ``fvaddr`` or ``paddr`` monitoring operations sets, users are
the ``contexts/<N>/operations`` file), DAMON automatically sets and updates the required to set the monitoring target address ranges. In case of ``vaddr``
monitoring target regions so that entire memory mappings of target processes operations set, it is not mandatory, but users can optionally set the initial
can be covered. However, users could want to set the initial monitoring region monitoring region to specific address ranges. Please refer to the :ref:`design
to specific address ranges. <damon_design_vaddr_target_regions_construction>` for more details.
In contrast, DAMON do not automatically sets and updates the monitoring target
regions when ``fvaddr`` or ``paddr`` monitoring operations sets are being used
(``fvaddr`` or ``paddr`` have written to the ``contexts/<N>/operations``).
Therefore, users should set the monitoring target regions by themselves in the
cases.
For such cases, users can explicitly set the initial monitoring target regions For such cases, users can explicitly set the initial monitoring target regions
as they want, by writing proper values to the files under this directory. as they want, by writing proper values to the files under this directory.
......
...@@ -83,12 +83,18 @@ describe how those work. ...@@ -83,12 +83,18 @@ describe how those work.
- paddr: Monitor the physical address space of the system - paddr: Monitor the physical address space of the system
.. _damon_design_vaddr_target_regions_construction:
VMA-based Target Address Range Construction VMA-based Target Address Range Construction
------------------------------------------- -------------------------------------------
This is only for the virtual address space monitoring operations A mechanism of ``vaddr`` DAMON operations set that automatically initializes
implementation. That for the physical address space simply asks users to and updates the monitoring target address regions so that entire memory
manually set the monitoring target address ranges. mappings of the target processes can be covered.
This mechanism is only for the ``vaddr`` operations set. In cases of
``fvaddr`` and ``paddr`` operation sets, users are asked to manually set the
monitoring target address ranges.
Only small parts in the super-huge virtual address space of the processes are Only small parts in the super-huge virtual address space of the processes are
mapped to the physical memory and accessed. Thus, tracking the unmapped mapped to the physical memory and accessed. Thus, tracking the unmapped
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment