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
158   kdamond.  For more details, refer to :ref:`quotas directory <sysfs_quotas>`.
162 ``contexts`` directory contains files for controlling the monitoring contexts
170 In the beginning, this directory has only one file, ``nr_contexts``.  Writing a
172 ``0`` to ``N-1``.  Each directory represents each monitoring context (refer to
182 In each context directory, two files (``avail_operations`` and ``operations``)
205 and efficiency of the monitoring are in ``monitoring_attrs`` directory.
207 directory.
209 Under ``intervals`` directory, three files for DAMON's sampling interval
214 Under ``nr_regions`` directory, two files for the lower-bound and upper-bound
227 In the beginning, this directory has only one file, ``nr_targets``.  Writing a
229 to ``N-1``.  Each directory represents each monitoring target.
236 In each target directory, one file (``pid_target``) and one directory
255 as they want, by writing proper values to the files under this directory.
257 In the beginning, this directory has only one file, ``nr_regions``.  Writing a
259 to ``N-1``.  Each directory represents each initial monitoring target region.
266 In each region directory, you will find two files (``start`` and ``end``).  You
270 Each region should not overlap with others.  ``end`` of directory ``N`` should
271 be equal or smaller than ``start`` of directory ``N+1``.
278 The directory for DAMON-based Operation Schemes (:ref:`DAMOS
280 writing to files under this directory.
282 In the beginning, this directory has only one file, ``nr_schemes``.  Writing a
284 to ``N-1``.  Each directory represents each DAMON-based operation scheme.
291 In each scheme directory, five directories (``access_pattern``, ``quotas``,
312 The directory for the target access :ref:`pattern
315 Under the ``access_pattern`` directory, three directories (``sz``,
327 The directory for the :ref:`quotas <damon_design_damos_quotas>` of the given
330 Under ``quotas`` directory, four files (``ms``, ``bytes``,
352 Under ``weights`` directory, three files (``sz_permil``,
357 ``weights`` directory.
364 The directory for the :ref:`automatic quota tuning goals
368 In the beginning, this directory has only one file, ``nr_goals``.  Writing a
370 to ``N-1``.  Each directory represents each goal and current achievement.
373 Each goal directory contains three files, namely ``target_metric``,
379 directory <sysfs_kdamond>` to pass the feedback to DAMON.
386 The directory for the :ref:`watermarks <damon_design_damos_watermarks>` of the
389 Under the watermarks directory, five files (``metric``, ``interval_us``,
407 The directory for the :ref:`filters <damon_design_damos_filters>` of the given
410 In the beginning, this directory has only one file, ``nr_filters``.  Writing a
412 to ``N-1``.  Each directory represents each filter.  The filters are evaluated
415 Each filter directory contains six files, namely ``type``, ``matcing``,
462 The statistics can be retrieved by reading the files under ``stats`` directory
474 This directory initially has one file, ``total_bytes``.
479 directories named integer starting from ``0`` under this directory.  Each
480 directory contains files exposing detailed information about each of the memory
482 this directory, during next :ref:`apply interval <damon_design_damos>` of the
494 The expected usage of this directory is investigations of schemes' behaviors,
504 In each region directory, you will find four files (``start``, ``end``,
621 ``mk_contexts`` and ``rm_contexts`` under its debugfs directory,
887 directory of the name on the DAMON debugfs directory.  The directory will have
892     # ls: cannot access 'foo': No such file or directory
898 directory by putting the name of the context to the ``rm_contexts`` file. ::
902     # ls: cannot access 'foo': No such file or directory
905 are in the root directory only.