mm/damon/usage.rst

42 creates multiple directories and files under its sysfs directory,
44 from the files under the directory.
61 directory is having ``/`` suffix, and files in each directory are separated by
107 has one directory named ``admin``.  The directory contains the files for
109 having the root permission could use this directory.
116 Under the ``admin`` directory, one directory, ``kdamonds``, which has files for
119 details) exists.  In the beginning, this directory has only one file,
121 child directories named ``0`` to ``N-1``.  Each directory represents each
129 In each kdamond directory, two files (``state`` and ``pid``) and one directory
147   action tried regions directory for each DAMON-based operation scheme of the
149   regions directory, please refer to
154   action tried regions directory for each DAMON-based operation scheme of the
159 ``contexts`` directory contains files for controlling the monitoring contexts
167 In the beginning, this directory has only one file, ``nr_contexts``.  Writing a
169 ``0`` to ``N-1``.  Each directory represents each monitoring context (refer to
179 In each context directory, two files (``avail_operations`` and ``operations``)
193 Please refer to :ref:`regions sysfs directory <sysfs_regions>` for detailed
207 and efficiency of the monitoring are in ``monitoring_attrs`` directory.
209 directory.
211 Under ``intervals`` directory, three files for DAMON's sampling interval
216 Under ``nr_regions`` directory, two files for the lower-bound and upper-bound
229 In the beginning, this directory has only one file, ``nr_targets``.  Writing a
231 to ``N-1``.  Each directory represents each monitoring target.
238 In each target directory, one file (``pid_target``) and one directory
263 as they want, by writing proper values to the files under this directory.
265 In the beginning, this directory has only one file, ``nr_regions``.  Writing a
267 to ``N-1``.  Each directory represents each initial monitoring target region.
274 In each region directory, you will find two files (``start`` and ``end``).  You
278 Each region should not overlap with others.  ``end`` of directory ``N`` should
279 be equal or smaller than ``start`` of directory ``N+1``.
286 The directory for DAMON-based Operation Schemes (:ref:`DAMOS
288 writing to files under this directory.
290 In the beginning, this directory has only one file, ``nr_schemes``.  Writing a
292 to ``N-1``.  Each directory represents each DAMON-based operation scheme.
299 In each scheme directory, five directories (``access_pattern``, ``quotas``,
335 The directory for the target access :ref:`pattern
338 Under the ``access_pattern`` directory, three directories (``sz``,
350 The directory for the :ref:`quotas <damon_design_damos_quotas>` of the given
353 Under ``quotas`` directory, three files (``ms``, ``bytes``,
364 Under ``weights`` directory, three files (``sz_permil``,
369 ``weights`` directory.
376 The directory for the :ref:`automatic quota tuning goals
380 In the beginning, this directory has only one file, ``nr_goals``.  Writing a
382 to ``N-1``.  Each directory represents each goal and current achievement.
385 Each goal directory contains two files, namely ``target_value`` and
391 directory <sysfs_kdamond>` to pass the feedback to DAMON.
398 The directory for the :ref:`watermarks <damon_design_damos_watermarks>` of the
401 Under the watermarks directory, five files (``metric``, ``interval_us``,
419 The directory for the :ref:`filters <damon_design_damos_filters>` of the given
422 In the beginning, this directory has only one file, ``nr_filters``.  Writing a
424 to ``N-1``.  Each directory represents each filter.  The filters are evaluated
427 Each filter directory contains six files, namely ``type``, ``matcing``,
474 The statistics can be retrieved by reading the files under ``stats`` directory
486 This directory initially has one file, ``total_bytes``.
491 directories named integer starting from ``0`` under this directory.  Each
492 directory contains files exposing detailed information about each of the memory
494 this directory, during next :ref:`apply interval <damon_design_damos>` of the
506 The expected usage of this directory is investigations of schemes' behaviors,
516 In each region directory, you will find four files (``start``, ``end``,
633 ``rm_contexts`` under its debugfs directory, ``<debugfs>/damon/``.
893 directory of the name on the DAMON debugfs directory.  The directory will have
898     # ls: cannot access 'foo': No such file or directory
904 directory by putting the name of the context to the ``rm_contexts`` file. ::
908     # ls: cannot access 'foo': No such file or directory
911 root directory only.