Commit 0b43f89e authored by SeongJae Park's avatar SeongJae Park Committed by Andrew Morton
Browse files

Docs/admin-guide/mm/damon/usage: update for nr_snapshots damos stat 

Update DAMON usage document for the newly added damos stat, nr_snapshots.

Link: https://lkml.kernel.org/r/20251216080128.42991-5-sj@kernel.org


Signed-off-by: default avatarSeongJae Park <sj@kernel.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: Liam Howlett <liam.howlett@oracle.com>
Cc: Lorenzo Stoakes <lorenzo.stoakes@oracle.com>
Cc: "Masami Hiramatsu (Google)" <mhiramat@kernel.org>
Cc: Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
Cc: Michal Hocko <mhocko@suse.com>
Cc: Mike Rapoport <rppt@kernel.org>
Cc: Steven Rostedt <rostedt@goodmis.org>
Cc: Suren Baghdasaryan <surenb@google.com>
Cc: Vlastimil Babka <vbabka@suse.cz>
Signed-off-by: default avatarAndrew Morton <akpm@linux-foundation.org>
parent ee7f5d19

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

+4 −4
Original line number Diff line number Diff line
@@ -87,7 +87,7 @@ comma (","). 
    │ │ │ │ │ │ │ │ 0/type,matching,allow,memcg_path,addr_start,addr_end,target_idx,min,max

    │ │ │ │ │ │ │ :ref:`dests <damon_sysfs_dests>`/nr_dests

    │ │ │ │ │ │ │ │ 0/id,weight

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

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

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

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

    │ │ │ │ │ │ │ │ ...
@@ -543,9 +543,9 @@ online analysis or tuning of the schemes. Refer to :ref:`design doc 


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

(``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,

``sz_ops_filter_passed``, ``qt_exceeds`` and ``nr_snapshots``), 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: