162306a36Sopenharmony_ci.. SPDX-License-Identifier: GPL-2.0
262306a36Sopenharmony_ci
362306a36Sopenharmony_ci==========================
462306a36Sopenharmony_ciDAMON: Data Access MONitor
562306a36Sopenharmony_ci==========================
662306a36Sopenharmony_ci
762306a36Sopenharmony_ciDAMON is a Linux kernel subsystem that provides a framework for data access
862306a36Sopenharmony_cimonitoring and the monitoring results based system operations.  The core
962306a36Sopenharmony_cimonitoring mechanisms of DAMON (refer to :doc:`design` for the detail) make it
1062306a36Sopenharmony_ci
1162306a36Sopenharmony_ci - *accurate* (the monitoring output is useful enough for DRAM level memory
1262306a36Sopenharmony_ci   management; It might not appropriate for CPU Cache levels, though),
1362306a36Sopenharmony_ci - *light-weight* (the monitoring overhead is low enough to be applied online),
1462306a36Sopenharmony_ci   and
1562306a36Sopenharmony_ci - *scalable* (the upper-bound of the overhead is in constant range regardless
1662306a36Sopenharmony_ci   of the size of target workloads).
1762306a36Sopenharmony_ci
1862306a36Sopenharmony_ciUsing this framework, therefore, the kernel can operate system in an
1962306a36Sopenharmony_ciaccess-aware fashion.  Because the features are also exposed to the user space,
2062306a36Sopenharmony_ciusers who have special information about their workloads can write personalized
2162306a36Sopenharmony_ciapplications for better understanding and optimizations of their workloads and
2262306a36Sopenharmony_cisystems.
2362306a36Sopenharmony_ci
2462306a36Sopenharmony_ciFor easier development of such systems, DAMON provides a feature called DAMOS
2562306a36Sopenharmony_ci(DAMon-based Operation Schemes) in addition to the monitoring.  Using the
2662306a36Sopenharmony_cifeature, DAMON users in both kernel and user spaces can do access-aware system
2762306a36Sopenharmony_cioperations with no code but simple configurations.
2862306a36Sopenharmony_ci
2962306a36Sopenharmony_ci.. toctree::
3062306a36Sopenharmony_ci   :maxdepth: 2
3162306a36Sopenharmony_ci
3262306a36Sopenharmony_ci   faq
3362306a36Sopenharmony_ci   design
3462306a36Sopenharmony_ci   api
3562306a36Sopenharmony_ci   maintainer-profile
36