iv/linux
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Docs/admin-guide/mm/damon/usage: update DAMOS actions/filters supports of each DAMON operations set

Browse Source 
Supports of each DAMOS action and filters are up to DAMON operations set
implementation, but it's not mentioned in detail on the documentation. 
Update the information on the usage document.

Link: https://lkml.kernel.org/r/20230110190400.119388-5-sj@kernel.org
Signed-off-by: SeongJae Park <sj@kernel.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: Shuah Khan <shuah@kernel.org>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
This commit is contained in:
SeongJae Park 2023-01-10 19:03:56 +00:00 committed by Andrew Morton
parent 86834644e3
commit 9a47c411cc
1 changed files with 28 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

41
Documentation/admin-guide/mm/damon/usage.rst
View File

@ -279,14 +279,25 @@ The ``action`` file is for setting and getting what action you want to apply to
memory regions having specific access pattern of the interest. The keywords memory regions having specific access pattern of the interest. The keywords
that can be written to and read from the file and their meaning are as below. that can be written to and read from the file and their meaning are as below.
- ``willneed``: Call ``madvise()`` for the region with ``MADV_WILLNEED`` Note that support of each action depends on the running DAMON operations set
- ``cold``: Call ``madvise()`` for the region with ``MADV_COLD`` `implementation <sysfs_contexts>`.
- ``pageout``: Call ``madvise()`` for the region with ``MADV_PAGEOUT``
- ``hugepage``: Call ``madvise()`` for the region with ``MADV_HUGEPAGE`` - ``willneed``: Call ``madvise()`` for the region with ``MADV_WILLNEED``.
- ``nohugepage``: Call ``madvise()`` for the region with ``MADV_NOHUGEPAGE`` Supported by ``vaddr`` and ``fvaddr`` operations set.
- ``cold``: Call ``madvise()`` for the region with ``MADV_COLD``.
Supported by ``vaddr`` and ``fvaddr`` operations set.
- ``pageout``: Call ``madvise()`` for the region with ``MADV_PAGEOUT``.
Supported by ``vaddr``, ``fvaddr`` and ``paddr`` operations set.
- ``hugepage``: Call ``madvise()`` for the region with ``MADV_HUGEPAGE``.
Supported by ``vaddr`` and ``fvaddr`` operations set.
- ``nohugepage``: Call ``madvise()`` for the region with ``MADV_NOHUGEPAGE``.
Supported by ``vaddr`` and ``fvaddr`` operations set.
- ``lru_prio``: Prioritize the region on its LRU lists. - ``lru_prio``: Prioritize the region on its LRU lists.
Supported by ``paddr`` operations set.
- ``lru_deprio``: Deprioritize the region on its LRU lists. - ``lru_deprio``: Deprioritize the region on its LRU lists.
- ``stat``: Do nothing but count the statistics Supported by ``paddr`` operations set.
- ``stat``: Do nothing but count the statistics.
Supported by all operations sets.
schemes/<N>/access_pattern/ schemes/<N>/access_pattern/
--------------------------- ---------------------------
@ -388,8 +399,8 @@ pages of all memory cgroups except ``/having_care_already``.::
echo /having_care_already > 1/memcg_path echo /having_care_already > 1/memcg_path
echo N > 1/matching echo N > 1/matching
Note that filters could be ignored depend on the running DAMON operations set Note that filters are currently supported only when ``paddr``
`implementation <sysfs_contexts>`. `implementation <sysfs_contexts>` is being used.
.. _sysfs_schemes_stats: .. _sysfs_schemes_stats:
@ -618,11 +629,15 @@ The ``<action>`` is a predefined integer for memory management actions, which
DAMON will apply to the regions having the target access pattern. The DAMON will apply to the regions having the target access pattern. The
supported numbers and their meanings are as below. supported numbers and their meanings are as below.
- 0: Call ``madvise()`` for the region with ``MADV_WILLNEED`` - 0: Call ``madvise()`` for the region with ``MADV_WILLNEED``. Ignored if
- 1: Call ``madvise()`` for the region with ``MADV_COLD`` ``target`` is ``paddr``.
- 2: Call ``madvise()`` for the region with ``MADV_PAGEOUT`` - 1: Call ``madvise()`` for the region with ``MADV_COLD``. Ignored if
- 3: Call ``madvise()`` for the region with ``MADV_HUGEPAGE`` ``target`` is ``paddr``.
- 4: Call ``madvise()`` for the region with ``MADV_NOHUGEPAGE`` - 2: Call ``madvise()`` for the region with ``MADV_PAGEOUT``.
- 3: Call ``madvise()`` for the region with ``MADV_HUGEPAGE``. Ignored if
``target`` is ``paddr``.
- 4: Call ``madvise()`` for the region with ``MADV_NOHUGEPAGE``. Ignored if
``target`` is ``paddr``.
- 5: Do nothing but count the statistics - 5: Do nothing but count the statistics
Quota Quota