@@ -67,7 +67,7 @@ comma (",").
6767 │ │ │ │ │ │ │ intervals_goal/access_bp,aggrs,min_sample_us,max_sample_us
6868 │ │ │ │ │ │ nr_regions/min,max
6969 │ │ │ │ │ :ref: `targets <sysfs_targets >`/nr_targets
70- │ │ │ │ │ │ :ref: `0 <sysfs_target >`/pid_target
70+ │ │ │ │ │ │ :ref: `0 <sysfs_target >`/pid_target,obsolete_target
7171 │ │ │ │ │ │ │ :ref: `regions <sysfs_regions >`/nr_regions
7272 │ │ │ │ │ │ │ │ :ref: `0 <sysfs_region >`/start,end
7373 │ │ │ │ │ │ │ │ ...
@@ -81,7 +81,7 @@ comma (",").
8181 │ │ │ │ │ │ │ :ref: `quotas <sysfs_quotas >`/ms,bytes,reset_interval_ms,effective_bytes
8282 │ │ │ │ │ │ │ │ weights/sz_permil,nr_accesses_permil,age_permil
8383 │ │ │ │ │ │ │ │ :ref: `goals <sysfs_schemes_quota_goals >`/nr_goals
84- │ │ │ │ │ │ │ │ │ 0/target_metric,target_value,current_value,nid
84+ │ │ │ │ │ │ │ │ │ 0/target_metric,target_value,current_value,nid,path
8585 │ │ │ │ │ │ │ :ref: `watermarks <sysfs_watermarks >`/metric,interval_us,high,mid,low
8686 │ │ │ │ │ │ │ :ref: `{core_,ops_,}filters <sysfs_filters >`/nr_filters
8787 │ │ │ │ │ │ │ │ 0/type,matching,allow,memcg_path,addr_start,addr_end,target_idx,min,max
@@ -134,7 +134,8 @@ Users can write below commands for the kdamond to the ``state`` file.
134134- ``on ``: Start running.
135135- ``off ``: Stop running.
136136- ``commit ``: Read the user inputs in the sysfs files except ``state `` file
137- again.
137+ again. Monitoring :ref: `target region <sysfs_regions >` inputs are also be
138+ ignored if no target region is specified.
138139- ``update_tuned_intervals ``: Update the contents of ``sample_us `` and
139140 ``aggr_us `` files of the kdamond with the auto-tuning applied ``sampling
140141 interval `` and ``aggregation interval `` for the files. Please refer to
@@ -264,13 +265,20 @@ to ``N-1``. Each directory represents each monitoring target.
264265targets/<N>/
265266------------
266267
267- In each target directory, one file (``pid_target ``) and one directory
268- (``regions ``) exist.
268+ In each target directory, two files (``pid_target `` and `` obsolete_target ``)
269+ and one directory (``regions ``) exist.
269270
270271If you wrote ``vaddr `` to the ``contexts/<N>/operations ``, each target should
271272be a process. You can specify the process to DAMON by writing the pid of the
272273process to the ``pid_target `` file.
273274
275+ Users can selectively remove targets in the middle of the targets array by
276+ writing non-zero value to ``obsolete_target `` file and committing it (writing
277+ ``commit `` to ``state `` file). DAMON will remove the matching targets from its
278+ internal targets array. Users are responsible to construct target directories
279+ again, so that those correctly represent the changed internal targets array.
280+
281+
274282.. _sysfs_regions :
275283
276284targets/<N>/regions
@@ -289,6 +297,11 @@ In the beginning, this directory has only one file, ``nr_regions``. Writing a
289297number (``N ``) to the file creates the number of child directories named ``0 ``
290298to ``N-1 ``. Each directory represents each initial monitoring target region.
291299
300+ If ``nr_regions `` is zero when committing new DAMON parameters online (writing
301+ ``commit `` to ``state `` file of :ref: `kdamond <sysfs_kdamond >`), the commit
302+ logic ignores the target regions. In other words, the current monitoring
303+ results for the target are preserved.
304+
292305.. _sysfs_region :
293306
294307regions/<N>/
@@ -402,9 +415,9 @@ number (``N``) to the file creates the number of child directories named ``0``
402415to ``N-1 ``. Each directory represents each goal and current achievement.
403416Among the multiple feedback, the best one is used.
404417
405- Each goal directory contains four files, namely ``target_metric ``,
406- ``target_value ``, ``current_value `` and ``nid ``. Users can set and get the
407- four parameters for the quota auto-tuning goals that specified on the
418+ Each goal directory contains five files, namely ``target_metric ``,
419+ ``target_value ``, ``current_value `` `` nid `` and ``path ``. Users can set and
420+ get the five parameters for the quota auto-tuning goals that specified on the
408421:ref: `design doc <damon_design_damos_quotas_auto_tuning >` by writing to and
409422reading from each of the files. Note that users should further write
410423``commit_schemes_quota_goals `` to the ``state `` file of the :ref: `kdamond
0 commit comments