mm/damon/usage.rst

36 creates multiple directories and files under its sysfs directory,
38 from the files under the directory.
55 directory is having ``/`` suffix, and files in each directory are separated by
104 has one directory named ``admin``.  The directory contains the files for
106 having the root permission could use this directory.
113 Under the ``admin`` directory, one directory, ``kdamonds``, which has files for
116 details) exists.  In the beginning, this directory has only one file,
118 child directories named ``0`` to ``N-1``.  Each directory represents each
126 In each kdamond directory, three files (``state``, ``pid`` and ``refresh_ms``)
127 and one directory (``contexts``) exist.
149   action tried regions directory for each DAMON-based operation scheme of the
151   regions directory, please refer to
156   action tried regions directory for each DAMON-based operation scheme of the
160   kdamond.  For more details, refer to :ref:`quotas directory <sysfs_quotas>`.
171 ``contexts`` directory contains files for controlling the monitoring contexts
179 In the beginning, this directory has only one file, ``nr_contexts``.  Writing a
181 ``0`` to ``N-1``.  Each directory represents each monitoring context (refer to
191 In each context directory, two files (``avail_operations`` and ``operations``)
214 and efficiency of the monitoring are in ``monitoring_attrs`` directory.
216 directory.
218 Under ``intervals`` directory, three files for DAMON's sampling interval
223 Under ``nr_regions`` directory, two files for the lower-bound and upper-bound
236 Under the ``intervals`` directory, one directory for automated tuning of
237 ``sample_us`` and ``aggr_us``, namely ``intervals_goal`` directory also exists.
238 Under the directory, four files for the auto-tuning control, namely
243 directory shows and updates the tuning parameters that described in the
255 In the beginning, this directory has only one file, ``nr_targets``.  Writing a
257 to ``N-1``.  Each directory represents each monitoring target.
264 In each target directory, one file (``pid_target``) and one directory
283 as they want, by writing proper values to the files under this directory.
285 In the beginning, this directory has only one file, ``nr_regions``.  Writing a
287 to ``N-1``.  Each directory represents each initial monitoring target region.
294 In each region directory, you will find two files (``start`` and ``end``).  You
298 Each region should not overlap with others.  ``end`` of directory ``N`` should
299 be equal or smaller than ``start`` of directory ``N+1``.
306 The directory for DAMON-based Operation Schemes (:ref:`DAMOS
308 writing to files under this directory.
310 In the beginning, this directory has only one file, ``nr_schemes``.  Writing a
312 to ``N-1``.  Each directory represents each DAMON-based operation scheme.
319 In each scheme directory, eight directories (``access_pattern``, ``quotas``,
341 The directory for the target access :ref:`pattern
344 Under the ``access_pattern`` directory, three directories (``sz``,
356 The directory for the :ref:`quotas <damon_design_damos_quotas>` of the given
359 Under ``quotas`` directory, four files (``ms``, ``bytes``,
381 Under ``weights`` directory, three files (``sz_permil``,
386 ``weights`` directory.
393 The directory for the :ref:`automatic quota tuning goals
397 In the beginning, this directory has only one file, ``nr_goals``.  Writing a
399 to ``N-1``.  Each directory represents each goal and current achievement.
402 Each goal directory contains four files, namely ``target_metric``,
408 directory <sysfs_kdamond>` to pass the feedback to DAMON.
415 The directory for the :ref:`watermarks <damon_design_damos_watermarks>` of the
418 Under the watermarks directory, five files (``metric``, ``interval_us``,
441 directory can be used for installing filters regardless of their handled
445 Use of ``filters`` directory can make expecting evaluation orders of given
446 filters with the files under directory bit confusing.  Users are hence
448 ``filters`` directory could be deprecated in future.
450 In the beginning, the directory has only one file, ``nr_filters``.  Writing a
452 to ``N-1``.  Each directory represents each filter.  The filters are evaluated
455 Each filter directory contains nine files, namely ``type``, ``matching``,
501 Directory for specifying the destinations of given DAMON-based operation
502 scheme's action.  This directory is ignored if the action of the given scheme
506 In the beginning, the directory has only one file, ``nr_dests``.  Writing a
508 to ``N-1``.  Each directory represents each action destination.
510 Each destination directory contains two files, namely ``id`` and ``weight``.
528 The statistics can be retrieved by reading the files under ``stats`` directory
540 This directory initially has one file, ``total_bytes``.
545 directories named integer starting from ``0`` under this directory.  Each
546 directory contains files exposing detailed information about each of the memory
548 this directory, during next :ref:`apply interval <damon_design_damos>` of the
560 The expected usage of this directory is investigations of schemes' behaviors,
570 In each region directory, you will find five files (``start``, ``end``,