mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2025-01-06 05:06:29 +00:00
e191759091
Kernel documentation is the most up-to-date and recommended resource for DAMON. It doesn't cover non-kernel part of the entire project[1], though. Also it is not optimum for formal long-term citations. Depending on cases, DAMON academic papers[2,3] could be better to be read and cited. However, there is no clear guidance for those. Add a paragraph for DAMON academic papers on the kernel documentation for DAMON. [1] https://damonitor.github.io [2] https://dl.acm.org/doi/abs/10.1145/3366626.3368125 [3] https://dl.acm.org/doi/abs/10.1145/3502181.353146 Link: https://lkml.kernel.org/r/20241101203557.55210-1-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>
46 lines
1.9 KiB
ReStructuredText
46 lines
1.9 KiB
ReStructuredText
.. SPDX-License-Identifier: GPL-2.0
|
|
|
|
==========================
|
|
DAMON: Data Access MONitor
|
|
==========================
|
|
|
|
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.
|