[linux-block.git] / Documentation / mm / damon / index.rst

.. 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>`.
Commit	Line	Data
c4ba6014 SP	1	.. SPDX-License-Identifier: GPL-2.0
	2
	3	==========================
	4	DAMON: Data Access MONitor
	5	==========================
	6
86834644 SP	7	DAMON is a Linux kernel subsystem that provides a framework for data access
86834644 SP	8	monitoring and the monitoring results based system operations. The core
5fb9f044	9	monitoring :ref:`mechanisms <damon_design_monitoring>` of DAMON make it
c4ba6014 SP	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
86834644	18	Using this framework, therefore, the kernel can operate system in an
f6a6de24 SP	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.
86834644	23
5fb9f044 SP	24	For easier development of such systems, DAMON provides a feature called
5fb9f044 SP	25	:ref:`DAMOS <damon_design_damos>` (DAMon-based Operation Schemes) in addition
f6a6de24 SP	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.
c4ba6014 SP	29
	30	.. toctree::
	31	:maxdepth: 2
	32
	33	faq
	34	design
	35	api
e7366f3a	36	maintainer-profile
f6a6de24 SP	37
	38	To utilize and control DAMON from the user-space, please refer to the
	39	administration :doc:`guide </admin-guide/mm/damon/index>`.