Commit 0972913f authored by SeongJae Park's avatar SeongJae Park Committed by Andrew Morton

Docs/ABI/damon: document DAMOS quota goals

Update DAMON ABI document for the newly added DAMON sysfs files and inputs
for DAMOS quota goals.

Link: https://lkml.kernel.org/r/20231130023652.50284-9-sj@kernel.orgSigned-off-by: default avatarSeongJae Park <sj@kernel.org>
Cc: Brendan Higgins <brendanhiggins@google.com>
Cc: David Gow <davidgow@google.com>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: Shuah Khan <shuah@kernel.org>
Signed-off-by: default avatarAndrew Morton <akpm@linux-foundation.org>
parent 3143a7bf
...@@ -25,12 +25,14 @@ Description: Writing 'on' or 'off' to this file makes the kdamond starts or ...@@ -25,12 +25,14 @@ Description: Writing 'on' or 'off' to this file makes the kdamond starts or
stops, respectively. Reading the file returns the keywords stops, respectively. Reading the file returns the keywords
based on the current status. Writing 'commit' to this file based on the current status. Writing 'commit' to this file
makes the kdamond reads the user inputs in the sysfs files makes the kdamond reads the user inputs in the sysfs files
except 'state' again. Writing 'update_schemes_stats' to the except 'state' again. Writing 'commit_schemes_quota_goals' to
file updates contents of schemes stats files of the kdamond. this file makes the kdamond reads the quota goal files again.
Writing 'update_schemes_tried_regions' to the file updates Writing 'update_schemes_stats' to the file updates contents of
contents of 'tried_regions' directory of every scheme directory schemes stats files of the kdamond. Writing
of this kdamond. Writing 'update_schemes_tried_bytes' to the 'update_schemes_tried_regions' to the file updates contents of
file updates only '.../tried_regions/total_bytes' files of this 'tried_regions' directory of every scheme 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 kdamond. Writing 'clear_schemes_tried_regions' to the file
removes contents of the 'tried_regions' directory. removes contents of the 'tried_regions' directory.
...@@ -212,6 +214,25 @@ Contact: SeongJae Park <sj@kernel.org> ...@@ -212,6 +214,25 @@ Contact: SeongJae Park <sj@kernel.org>
Description: Writing to and reading from this file sets and gets the quotas Description: Writing to and reading from this file sets and gets the quotas
charge reset interval of the scheme in milliseconds. charge reset interval of the scheme in milliseconds.
What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/goals/nr_goals
Date: Nov 2023
Contact: SeongJae Park <sj@kernel.org>
Description: Writing a number 'N' to this file creates the number of
directories for setting automatic tuning of the scheme's
aggressiveness named '0' to 'N-1' under the goals/ directory.
What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/goals/<G>/target_value
Date: Nov 2023
Contact: SeongJae Park <sj@kernel.org>
Description: Writing to and reading from this file sets and gets the target
value of the goal metric.
What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/goals/<G>/current_value
Date: Nov 2023
Contact: SeongJae Park <sj@kernel.org>
Description: Writing to and reading from this file sets and gets the current
value of the goal metric.
What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/weights/sz_permil What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/weights/sz_permil
Date: Mar 2022 Date: Mar 2022
Contact: SeongJae Park <sj@kernel.org> Contact: SeongJae Park <sj@kernel.org>
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment