Commit 2584dd74 authored by SeongJae Park's avatar SeongJae Park Committed by Andrew Morton
Browse files

Docs/admin-guide/mm/damon/usage: update for max_nr_snapshots 

Update DAMON usage document for the newly added DAMON sysfs interface
file, max_nr_snapshots.

Link: https://lkml.kernel.org/r/20251216080128.42991-11-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 64aa87f0

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

+6 −5
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,nr_snapshots

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

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

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

    │ │ │ │ │ │ │ │ ...
@@ -543,10 +543,11 @@ 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``, ``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.

``sz_ops_filter_passed``, ``qt_exceeds``, ``nr_snapshots`` and

``max_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: