Lines Matching +full:three +full:- +full:state
1 .. SPDX-License-Identifier: GPL-2.0
9 - *DAMON user space tool.*
11 system administrators who want a just-working human-friendly interface.
12 Using this, users can use the DAMON’s major features in a human-friendly way.
16 - *sysfs interface.*
23 - *Kernel Space Programming Interface.*
48 # echo on > kdamonds/0/state
51 ---------------
54 figure, parents-children relations are represented with indentations, each
58 .. parsed-literal::
62 │ │ :ref:`0 <sysfs_kdamond>`/state,pid
99 ----
109 ---------
116 child directories named ``0`` to ``N-1``. Each directory represents each
122 -------------
124 In each kdamond directory, two files (``state`` and ``pid``) and one directory
127 Reading ``state`` returns ``on`` if the kdamond is currently running, or
130 Users can write below commands for the kdamond to the ``state`` file.
132 - ``on``: Start running.
133 - ``off``: Stop running.
134 - ``commit``: Read the user inputs in the sysfs files except ``state`` file
136 - ``update_tuned_intervals``: Update the contents of ``sample_us`` and
137 ``aggr_us`` files of the kdamond with the auto-tuning applied ``sampling
141 - ``commit_schemes_quota_goals``: Read the DAMON-based operation schemes'
143 - ``update_schemes_stats``: Update the contents of stats files for each
144 DAMON-based operation scheme of the kdamond. For details of the stats,
146 - ``update_schemes_tried_regions``: Update the DAMON-based operation scheme
147 action tried regions directory for each DAMON-based operation scheme of the
148 kdamond. For details of the DAMON-based operation scheme action tried
151 - ``update_schemes_tried_bytes``: Update only ``.../tried_regions/total_bytes``
153 - ``clear_schemes_tried_regions``: Clear the DAMON-based operating scheme
154 action tried regions directory for each DAMON-based operation scheme of the
156 - ``update_schemes_effective_quotas``: Update the contents of
157 ``effective_bytes`` files for each DAMON-based operation scheme of the
160 If the state is ``on``, reading ``pid`` shows the pid of the kdamond thread.
168 ----------------------
172 ``0`` to ``N-1``. Each directory represents each monitoring context (refer to
180 -------------
183 and three directories (``monitoring_attrs``, ``targets``, and ``schemes``)
202 ------------------------------
209 Under ``intervals`` directory, three files for DAMON's sampling interval
211 (``update_us``) exist. You can set and get the values in micro-seconds by
214 Under ``nr_regions`` directory, two files for the lower-bound and upper-bound
225 -------------------------------------------------------
229 Under the directory, four files for the auto-tuning control, namely
236 names. The tuning starts with the user-set ``sample_us`` and ``aggr_us``. The
237 tuning-applied current values of the two intervals can be read from the
239 the ``state`` file.
244 ---------------------
248 to ``N-1``. Each directory represents each monitoring target.
253 ------------
265 -------------------
278 to ``N-1``. Each directory represents each initial monitoring target region.
283 ------------
295 ---------------------
297 The directory for DAMON-based Operation Schemes (:ref:`DAMOS
303 to ``N-1``. Each directory represents each DAMON-based operation scheme.
308 ------------
312 ``tried_regions``) and three files (``action``, ``target_nid`` and
330 ---------------------------
333 <damon_design_damos_access_pattern>` of the given DAMON-based operation scheme.
335 Under the ``access_pattern`` directory, three directories (``sz``,
345 -------------------
348 DAMON-based operation scheme.
355 ``reset interval`` in milliseconds by writing the values to the three files,
364 transformed size quota and user-specified size quota, smaller one is applied.
365 Based on the user-specified :ref:`goal <sysfs_schemes_quota_goals>`, the
370 the relevant ``kdamonds/<N>/state`` file.
372 Under ``weights`` directory, three files (``sz_permil``,
376 in per-thousand unit by writing the values to the three files under the
382 -------------------------
385 <damon_design_damos_quotas_auto_tuning>` of the given DAMON-based operation
390 to ``N-1``. Each directory represents each goal and current achievement.
393 Each goal directory contains three files, namely ``target_metric``,
394 ``target_value`` and ``current_value``. Users can set and get the three
395 parameters for the quota auto-tuning goals that specified on the :ref:`design
398 ``commit_schemes_quota_goals`` to the ``state`` file of the :ref:`kdamond
404 -----------------------
407 given DAMON-based operation scheme.
411 between check of the metric, and the three watermarks exist. You can set and
417 - none: Ignore the watermarks
418 - free_mem_rate: System's free memory rate (per thousand)
425 -----------------------------------
428 DAMON-based operation scheme.
434 installed before those of ``filters``. All three directories have same files.
443 to ``N-1``. Each directory represents each filter. The filters are evaluated
455 address of the range (open-ended interval) to ``addr_start`` and ``addr_end``
467 For example, below restricts a DAMOS action to be applied to only non-anonymous
490 ------------------
501 ``update_schemes_stats`` to the relevant ``kdamonds/<N>/state`` file.
506 --------------------------
511 relevant ``kdamonds/<N>/state`` file, DAMON updates the ``total_bytes`` file so
520 Writing ``update_schemes_tried_bytes`` to the relevant ``kdamonds/<N>/state``
526 ``kdamonds/<N>/state`` file.
529 and query-like efficient data access monitoring results retrievals. For the
536 ------------------
540 show the properties of the region that corresponding DAMON-based operation
594 provides the monitoring results for regions that each DAMON-based Operation
598 :ref:`pattern <damon_design_damos_access_pattern>` based query-like efficient
604 # echo on > kdamonds/0/state
605 # perf record -e damon:damon_aggregated &
608 # echo off > kdamonds/0/state
610 kdamond.0 46568 [027] 79357.842179: damon:damon_aggregated: target_id=0 nr_regions=11 122509119488-135708762112: 0 864
617 for the target. The eighth field (``X-Y:``) shows the start (``X``) and end
628 kdamond.0 47293 [000] 80801.060214: damon:damos_before_apply: ctx_idx=0 scheme_idx=0 target_idx=0 nr_regions=11 121932607488-135128711168: 0 136
631 Each line of the output represents each monitoring region that each DAMON-based