tjh.dev / kernel
Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux
1
fork

Configure Feed

Select the types of activity you want to include in your feed.

Docs/mm/damon/index: simplify the intro

Patch series "Docs/mm/damon: update intro, modules, maintainer profile,
and misc".

Update DAMON documentations for wordsmithing, clarifications, and
miscellaneous outdated things with eight patches. Patch 1 simplifies the
brief introduction of DAMON. Patch 2 updates DAMON user-space tool
packaged distros information on design doc to include not only Fedora, but
refer to repology. Three following patches update design and usage
documents for clarifying DAMON sample modules purposes (patch 3), and
outdated information about usages of DAMON modules (patches 4 and 5).
Final three patches update usage and maintainer-profile for sysfs
refresh_ms feature behavior (patch 6), synchronize DAMON MAINTAINERS
section name (patch 7), and broken damon-tests performance tests (patch
8).


This patch (of 8):

The intro is a bit verbose and redundant. Simplify it by replacing
details with more links to the design docs, and refining the design points
list.

Link: https://lkml.kernel.org/r/20260118180305.70023-1-sj@kernel.org
Link: https://lkml.kernel.org/r/20260118180305.70023-2-sj@kernel.org
Signed-off-by: SeongJae Park <sj@kernel.org>
Cc: David Hildenbrand <david@kernel.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: Liam Howlett <liam.howlett@oracle.com>
Cc: Lorenzo Stoakes <lorenzo.stoakes@oracle.com>
Cc: Michal Hocko <mhocko@suse.com>
Cc: Mike Rapoport <rppt@kernel.org>
Cc: Suren Baghdasaryan <surenb@google.com>
Cc: Vlastimil Babka <vbabka@suse.cz>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>

authored by

SeongJae Park and committed by
Andrew Morton 32d11b32 b94c3179

+8 -21
+8 -21
Documentation/mm/damon/index.rst
··· 4 4 DAMON: Data Access MONitoring and Access-aware System Operations 5 5 ================================================================ 6 6 7 - DAMON is a Linux kernel subsystem that provides a framework for data access 8 - monitoring and the monitoring results based system operations. The core 9 - monitoring :ref:`mechanisms <damon_design_monitoring>` of DAMON make it 7 + DAMON is a Linux kernel subsystem for efficient :ref:`data access monitoring 8 + <damon_design_monitoring>` and :ref:`access-aware system operations 9 + <damon_design_damos>`. It is designed for being 10 10 11 - - *accurate* (the monitoring output is useful enough for DRAM level memory 12 - management; It might not appropriate for CPU Cache levels, though), 13 - - *light-weight* (the monitoring overhead is low enough to be applied online), 14 - and 15 - - *scalable* (the upper-bound of the overhead is in constant range regardless 16 - of the size of target workloads). 17 - 18 - Using this framework, therefore, the kernel can operate system in an 19 - access-aware fashion. Because the features are also exposed to the :doc:`user 20 - space </admin-guide/mm/damon/index>`, users who have special information about 21 - their workloads can write personalized applications for better understanding 22 - and optimizations of their workloads and systems. 23 - 24 - For easier development of such systems, DAMON provides a feature called 25 - :ref:`DAMOS <damon_design_damos>` (DAMon-based Operation Schemes) in addition 26 - to the monitoring. Using the feature, DAMON users in both kernel and :doc:`user 27 - spaces </admin-guide/mm/damon/index>` can do access-aware system operations 28 - with no code but simple configurations. 11 + - *accurate* (for DRAM level memory management), 12 + - *light-weight* (for production online usages), 13 + - *scalable* (in terms of memory size), 14 + - *tunable* (for flexible usages), and 15 + - *autoamted* (for production operation without manual tunings). 29 16 30 17 .. toctree:: 31 18 :maxdepth: 2