[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 mechanisms of DAMON (refer to :doc:`design` for the detail) 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 user space,
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 DAMOS
(DAMon-based Operation Schemes) in addition to the monitoring.  Using the
feature, DAMON users in both kernel and user spaces can do access-aware system
operations with no code but simple configurations.

.. toctree::
   :maxdepth: 2

   faq
   design
   api
   maintainer-profile
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
	8	monitoring and the monitoring results based system operations. The core
	9	monitoring mechanisms of DAMON (refer to :doc:`design` for the detail) 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 SP	18	Using this framework, therefore, the kernel can operate system in an
	19	access-aware fashion. Because the features are also exposed to the user space,
	20	users who have special information about their workloads can write personalized
	21	applications for better understanding and optimizations of their workloads and
	22	systems.
	23
	24	For easier development of such systems, DAMON provides a feature called DAMOS
	25	(DAMon-based Operation Schemes) in addition to the monitoring. Using the
	26	feature, DAMON users in both kernel and user spaces can do access-aware system
	27	operations with no code but simple configurations.
c4ba6014 SP	28
	29	.. toctree::
	30	:maxdepth: 2
	31
	32	faq
	33	design
	34	api
e7366f3a	35	maintainer-profile