Commit 6bbdb28d authored by SeongJae Park's avatar SeongJae Park Committed by Andrew Morton
Browse files

Docs/admin-guide/mm/damon/usage: document sz_ops_filter_passed 

Document the new per-scheme operations set layer-handled DAMOS filters
passed bytes statistic file on DAMON sysfs interface usage document.

Link: https://lkml.kernel.org/r/20250106193401.109161-11-sj@kernel.org


Signed-off-by: default avatarSeongJae Park <sj@kernel.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Signed-off-by: default avatarAndrew Morton <akpm@linux-foundation.org>
parent 0f0a0bfd

Documentation/admin-guide/mm/damon/usage.rst

+9 −11
Original line number Diff line number Diff line
@@ -90,7 +90,7 @@ comma (","). 
    │ │ │ │ │ │ │ :ref:`watermarks <sysfs_watermarks>`/metric,interval_us,high,mid,low

    │ │ │ │ │ │ │ :ref:`filters <sysfs_filters>`/nr_filters

    │ │ │ │ │ │ │ │ 0/type,matching,memcg_id

    │ │ │ │ │ │ │ :ref:`stats <sysfs_schemes_stats>`/nr_tried,sz_tried,nr_applied,sz_applied,qt_exceeds

    │ │ │ │ │ │ │ :ref:`stats <sysfs_schemes_stats>`/nr_tried,sz_tried,nr_applied,sz_applied,sz_ops_filter_passed,qt_exceeds

    │ │ │ │ │ │ │ :ref:`tried_regions <sysfs_schemes_tried_regions>`/total_bytes

    │ │ │ │ │ │ │ │ 0/start,end,nr_accesses,age

    │ │ │ │ │ │ │ │ ...
@@ -454,18 +454,16 @@ difference is applied to :ref:`stats <damos_stats>` and 
schemes/<N>/stats/

------------------



DAMON counts the total number and bytes of regions that each scheme is tried to

be applied, the two numbers for the regions that each scheme is successfully

applied, and the total number of the quota limit exceeds.  This statistics can

be used for online analysis or tuning of the schemes.  Refer to :ref:`design

doc <damon_design_damos_stat>` for more details about the stats.

DAMON counts statistics for each scheme.  This statistics can be used for

online analysis or tuning of the schemes.  Refer to :ref:`design doc

<damon_design_damos_stat>` for more details about the stats.



The statistics can be retrieved by reading the files under ``stats`` directory

(``nr_tried``, ``sz_tried``, ``nr_applied``, ``sz_applied``, and

``qt_exceeds``), respectively.  The files are not updated in real time, so you

should ask DAMON sysfs interface to update the content of the files for the

stats by writing a special keyword, ``update_schemes_stats`` to the relevant

``kdamonds/<N>/state`` file.

(``nr_tried``, ``sz_tried``, ``nr_applied``, ``sz_applied``,

``sz_ops_filter_passed``, and ``qt_exceeds``), respectively.  The files are not

updated in real time, so you should ask DAMON sysfs interface to update the

content of the files for the stats by writing a special keyword,

``update_schemes_stats`` to the relevant ``kdamonds/<N>/state`` file.



.. _sysfs_schemes_tried_regions: