Skip to content

Commit 561f4fc

Browse files
sjp38torvalds
authored andcommitted
Docs/vm/damon: call low level monitoring primitives the operations
Patch series "Docs/damon: Update documents for better consistency". Some of DAMON document are not properly updated for latest version. This patchset updates such parts. This patch (of 3): DAMON code calls the low level monitoring primitives implementations the monitoring operations. The documentation would have no problem at still calling those primitives implementation because there is no real difference in the concepts, but making it more consistent with the code would make it better. This commit therefore convert sentences in the doc specifically pointing the implementations of the primitives to call it monitoring operations. Link: https://lkml.kernel.org/r/20220222170100.17068-1-sj@kernel.org Link: https://lkml.kernel.org/r/20220222170100.17068-2-sj@kernel.org Signed-off-by: SeongJae Park <sj@kernel.org> Cc: Jonathan Corbet <corbet@lwn.net> Signed-off-by: Andrew Morton <akpm@linux-foundation.org> Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
1 parent 3213a3c commit 561f4fc

2 files changed

Lines changed: 13 additions & 13 deletions

File tree

Documentation/vm/damon/design.rst

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -13,38 +13,38 @@ primitives that dependent on and optimized for the target address space. On
1313
the other hand, the accuracy and overhead tradeoff mechanism, which is the core
1414
of DAMON, is in the pure logic space. DAMON separates the two parts in
1515
different layers and defines its interface to allow various low level
16-
primitives implementations configurable with the core logic.
16+
primitives implementations configurable with the core logic. We call the low
17+
level primitives implementations monitoring operations.
1718

1819
Due to this separated design and the configurable interface, users can extend
19-
DAMON for any address space by configuring the core logics with appropriate low
20-
level primitive implementations. If appropriate one is not provided, users can
21-
implement the primitives on their own.
20+
DAMON for any address space by configuring the core logics with appropriate
21+
monitoring operations. If appropriate one is not provided, users can implement
22+
the operations on their own.
2223

2324
For example, physical memory, virtual memory, swap space, those for specific
2425
processes, NUMA nodes, files, and backing memory devices would be supportable.
2526
Also, if some architectures or devices support special optimized access check
2627
primitives, those will be easily configurable.
2728

2829

29-
Reference Implementations of Address Space Specific Primitives
30-
==============================================================
30+
Reference Implementations of Address Space Specific Monitoring Operations
31+
=========================================================================
3132

32-
The low level primitives for the fundamental access monitoring are defined in
33-
two parts:
33+
The monitoring operations are defined in two parts:
3434

3535
1. Identification of the monitoring target address range for the address space.
3636
2. Access check of specific address range in the target space.
3737

38-
DAMON currently provides the implementations of the primitives for the physical
38+
DAMON currently provides the implementations of the operations for the physical
3939
and virtual address spaces. Below two subsections describe how those work.
4040

4141

4242
VMA-based Target Address Range Construction
4343
-------------------------------------------
4444

45-
This is only for the virtual address space primitives implementation. That for
46-
the physical address space simply asks users to manually set the monitoring
47-
target address ranges.
45+
This is only for the virtual address space monitoring operations
46+
implementation. That for the physical address space simply asks users to
47+
manually set the monitoring target address ranges.
4848

4949
Only small parts in the super-huge virtual address space of the processes are
5050
mapped to the physical memory and accessed. Thus, tracking the unmapped

Documentation/vm/damon/faq.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ Does DAMON support virtual memory only?
3131
=======================================
3232

3333
No. The core of the DAMON is address space independent. The address space
34-
specific low level primitive parts including monitoring target regions
34+
specific monitoring operations including monitoring target regions
3535
constructions and actual access checks can be implemented and configured on the
3636
DAMON core by the users. In this way, DAMON users can monitor any address
3737
space with any access check technique.

0 commit comments

Comments
 (0)