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
101 has one directory named ``admin``.  The directory contains the files for
103 having the root permission could use this directory.
112 Under the ``admin`` directory, one directory, ``kdamonds``, which has files for
113 controlling the kdamonds exist.  In the beginning, this directory has only one
115 of child directories named ``0`` to ``N-1``.  Each directory represents each
121 In each kdamond directory, two files (``state`` and ``pid``) and one directory
133 DAMON-based operation scheme action tried regions directory for each
138 operating scheme action tried regions directory for each DAMON-based operation
140 tried regions directory, please refer to :ref:`tried_regions section
145 ``contexts`` directory contains files for controlling the monitoring contexts
151 In the beginning, this directory has only one file, ``nr_contexts``.  Writing a
153 ``0`` to ``N-1``.  Each directory represents each monitoring context.  At the
162 In each context directory, two files (``avail_operations`` and ``operations``)
176 Please refer to :ref:`regions sysfs directory <sysfs_regions>` for detailed
190 and efficiency of the monitoring are in ``monitoring_attrs`` directory.
192 directory.
194 Under ``intervals`` directory, three files for DAMON's sampling interval
199 Under ``nr_regions`` directory, two files for the lower-bound and upper-bound
210 In the beginning, this directory has only one file, ``nr_targets``.  Writing a
212 to ``N-1``.  Each directory represents each monitoring target.
217 In each target directory, one file (``pid_target``) and one directory
242 as they want, by writing proper values to the files under this directory.
244 In the beginning, this directory has only one file, ``nr_regions``.  Writing a
246 to ``N-1``.  Each directory represents each initial monitoring target region.
251 In each region directory, you will find two files (``start`` and ``end``).  You
255 Each region should not overlap with others.  ``end`` of directory ``N`` should
256 be equal or smaller than ``start`` of directory ``N+1``.
261 The directory for DAMON-based Operation Schemes (:ref:`DAMOS
263 writing to files under this directory.
265 In the beginning, this directory has only one file, ``nr_schemes``.  Writing a
267 to ``N-1``.  Each directory represents each DAMON-based operation scheme.
272 In each scheme directory, five directories (``access_pattern``, ``quotas``,
303 The directory for the target access :ref:`pattern
306 Under the ``access_pattern`` directory, three directories (``sz``,
316 The directory for the :ref:`quotas <damon_design_damos_quotas>` of the given
319 Under ``quotas`` directory, three files (``ms``, ``bytes``,
320 ``reset_interval_ms``) and one directory (``weights``) having three files
334 ``weights`` directory.
339 The directory for the :ref:`watermarks <damon_design_damos_watermarks>` of the
342 Under the watermarks directory, five files (``metric``, ``interval_us``,
358 The directory for the :ref:`filters <damon_design_damos_filters>` of the given
361 In the beginning, this directory has only one file, ``nr_filters``.  Writing a
363 to ``N-1``.  Each directory represents each filter.  The filters are evaluated
366 Each filter directory contains six files, namely ``type``, ``matcing``,
413 The statistics can be retrieved by reading the files under ``stats`` directory
425 This directory initially has one file, ``total_bytes``.
430 directories named integer starting from ``0`` under this directory.  Each
431 directory contains files exposing detailed information about each of the memory
433 this directory, during next :ref:`aggregation interval
445 The expected usage of this directory is investigations of schemes' behaviors,
453 In each region directory, you will find four files (``start``, ``end``,
514 ``rm_contexts`` under its debugfs directory, ``<debugfs>/damon/``.
774 directory of the name on the DAMON debugfs directory.  The directory will have
779     # ls: cannot access 'foo': No such file or directory
785 directory by putting the name of the context to the ``rm_contexts`` file. ::
789     # ls: cannot access 'foo': No such file or directory
792 root directory only.
802 While the tried regions directory is useful for getting a snapshot, the