Docs/ABI/damon: update for tried_regions/total_bytes
authorSeongJae Park <sj@kernel.org>
Wed, 2 Aug 2023 21:32:20 +0000 (21:32 +0000)
committerAndrew Morton <akpm@linux-foundation.org>
Mon, 21 Aug 2023 20:37:35 +0000 (13:37 -0700)
Update the DAMON ABI document for newly added
schemes/.../tried_regions/total_bytes file and the
update_schemes_tried_bytes command.

Link: https://lkml.kernel.org/r/20230802213222.109841-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>
Documentation/ABI/testing/sysfs-kernel-mm-damon

index 2744f21..3d9aaa1 100644 (file)
@@ -29,8 +29,10 @@ Description: Writing 'on' or 'off' to this file makes the kdamond starts or
                file updates contents of schemes stats files of the kdamond.
                Writing 'update_schemes_tried_regions' to the file updates
                contents of 'tried_regions' directory of every scheme directory
-               of this kdamond.  Writing 'clear_schemes_tried_regions' to the
-               file removes contents of the 'tried_regions' directory.
+               of this kdamond.  Writing 'update_schemes_tried_bytes' to the
+               file updates only '.../tried_regions/total_bytes' files of this
+               kdamond.  Writing 'clear_schemes_tried_regions' to the file
+               removes contents of the 'tried_regions' directory.
 
 What:          /sys/kernel/mm/damon/admin/kdamonds/<K>/pid
 Date:          Mar 2022
@@ -317,6 +319,13 @@ Contact:   SeongJae Park <sj@kernel.org>
 Description:   Reading this file returns the number of the exceed events of
                the scheme's quotas.
 
+What:          /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/tried_regions/total_bytes
+Date:          Jul 2023
+Contact:       SeongJae Park <sj@kernel.org>
+Description:   Reading this file returns the total amount of memory that
+               corresponding DAMON-based Operation Scheme's action has tried
+               to be applied.
+
 What:          /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/tried_regions/<R>/start
 Date:          Oct 2022
 Contact:       SeongJae Park <sj@kernel.org>