mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/chenhuacai/linux-loongson
synced 2025-08-28 18:10:32 +00:00
6a4b3551ba
DAMON was initially developed only for data access monitoring, and then extended for not only access monitoring but also access-aware system operations (DAMOS). But the documents have old titles and brief introductions for only the monitoring part. Update the titles and the brief introductions to explain DAMOS part together. Link: https://lkml.kernel.org/r/20250513002715.40126-7-sj@kernel.org Signed-off-by: SeongJae Park <sj@kernel.org> Cc: Brendan Higgins <brendan.higgins@linux.dev> Cc: David Gow <davidgow@google.com> Cc: Jonathan Corbet <corbet@lwn.net> Cc: Shuah Khan <shuah@kernel.org> Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
46 lines
2.0 KiB
ReStructuredText
46 lines
2.0 KiB
ReStructuredText
.. SPDX-License-Identifier: GPL-2.0
|
|
|
|
================================================================
|
|
DAMON: Data Access MONitoring and Access-aware System Operations
|
|
================================================================
|
|
|
|
DAMON is a Linux kernel subsystem that provides a framework for data access
|
|
monitoring and the monitoring results based system operations. The core
|
|
monitoring :ref:`mechanisms <damon_design_monitoring>` of DAMON make it
|
|
|
|
- *accurate* (the monitoring output is useful enough for DRAM level memory
|
|
management; It might not appropriate for CPU Cache levels, though),
|
|
- *light-weight* (the monitoring overhead is low enough to be applied online),
|
|
and
|
|
- *scalable* (the upper-bound of the overhead is in constant range regardless
|
|
of the size of target workloads).
|
|
|
|
Using this framework, therefore, the kernel can operate system in an
|
|
access-aware fashion. Because the features are also exposed to the :doc:`user
|
|
space </admin-guide/mm/damon/index>`, users who have special information about
|
|
their workloads can write personalized applications for better understanding
|
|
and optimizations of their workloads and systems.
|
|
|
|
For easier development of such systems, DAMON provides a feature called
|
|
:ref:`DAMOS <damon_design_damos>` (DAMon-based Operation Schemes) in addition
|
|
to the monitoring. Using the feature, DAMON users in both kernel and :doc:`user
|
|
spaces </admin-guide/mm/damon/index>` can do access-aware system operations
|
|
with no code but simple configurations.
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
|
|
faq
|
|
design
|
|
api
|
|
maintainer-profile
|
|
|
|
To utilize and control DAMON from the user-space, please refer to the
|
|
administration :doc:`guide </admin-guide/mm/damon/index>`.
|
|
|
|
If you prefer academic papers for reading and citations, please use the papers
|
|
from `HPDC'22 <https://dl.acm.org/doi/abs/10.1145/3502181.3531466>`_ and
|
|
`Middleware19 Industry <https://dl.acm.org/doi/abs/10.1145/3366626.3368125>`_ .
|
|
Note that those cover DAMON implementations in Linux v5.16 and v5.15,
|
|
respectively.
|