From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 0BD5F2253EF for ; Sun, 18 Jan 2026 19:21:30 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1768764090; cv=none; b=qavfUm87/bKqiikMZi87I/dagDA5dHAL9LhY5TdRuaU9AMWrV9kZiG6xd/2ym5vEg1bYop/JRCwlY/45SPLhxEX7XMmQRh7EwdzMnq1183l4KHBUbTPY6+0nWFRazPIlyfKxJZuMmV+Z8grkQukByZj++uxnyxlvciXGFR8m4pA= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1768764090; c=relaxed/simple; bh=i3ym5ofZt9lvEX7exu/LOVTFcZTZUiRr4Kh13sSmWuY=; h=Date:To:From:Subject:Message-Id; b=L9waduAlB4fbE+RR0aXSA5Y6Qf+gGikHEaguR0VUYQtdjM16BWE+6GDS0e5so/Nk2ga9dJI+5fPOU9kw2cOKScYO7UqRKF4zO5IEzYE0vgqoww43sRVspfq6tHlCSajgCMXxEQ1ATWBvlVWfCpizEPAcnRDvYl+0uBtHuEtQdtE= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dkim=pass (1024-bit key) header.d=linux-foundation.org header.i=@linux-foundation.org header.b=wsEPGX3/; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (1024-bit key) header.d=linux-foundation.org header.i=@linux-foundation.org header.b="wsEPGX3/" Received: by smtp.kernel.org (Postfix) with ESMTPSA id CE4DAC116D0; Sun, 18 Jan 2026 19:21:29 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=linux-foundation.org; s=korg; t=1768764089; bh=i3ym5ofZt9lvEX7exu/LOVTFcZTZUiRr4Kh13sSmWuY=; h=Date:To:From:Subject:From; b=wsEPGX3/maCTbnWy9pU5/lWTUb2jufPc75Gv9fBZMMDBtQyIMydL5Qf76DKEpoOjB IJnY0+1Jtty6nBsg/q9yiMazS9hxoSw21paL2/ZQyV8J6siLe4VoDUXENaVRZ8Jo2x N6rYb9DM/lbDjapxKGdpi8OPB68T9tYeFn823so4= Date: Sun, 18 Jan 2026 11:21:29 -0800 To: mm-commits@vger.kernel.org,vbabka@suse.cz,surenb@google.com,rppt@kernel.org,mhocko@suse.com,lorenzo.stoakes@oracle.com,liam.howlett@oracle.com,david@kernel.org,corbet@lwn.net,sj@kernel.org,akpm@linux-foundation.org From: Andrew Morton Subject: + docs-admin-guide-mm-damon-usage-update-stats-update-process-for-refresh_ms.patch added to mm-new branch Message-Id: <20260118192129.CE4DAC116D0@smtp.kernel.org> Precedence: bulk X-Mailing-List: mm-commits@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: The patch titled Subject: Docs/admin-guide/mm/damon/usage: update stats update process for refresh_ms has been added to the -mm mm-new branch. Its filename is docs-admin-guide-mm-damon-usage-update-stats-update-process-for-refresh_ms.patch This patch will shortly appear at https://git.kernel.org/pub/scm/linux/kernel/git/akpm/25-new.git/tree/patches/docs-admin-guide-mm-damon-usage-update-stats-update-process-for-refresh_ms.patch This patch will later appear in the mm-new branch at git://git.kernel.org/pub/scm/linux/kernel/git/akpm/mm Note, mm-new is a provisional staging ground for work-in-progress patches, and acceptance into mm-new is a notification for others take notice and to finish up reviews. Please do not hesitate to respond to review feedback and post updated versions to replace or incrementally fixup patches in mm-new. The mm-new branch of mm.git is not included in linux-next Before you just go and hit "reply", please: a) Consider who else should be cc'ed b) Prefer to cc a suitable mailing list as well c) Ideally: find the original patch on the mailing list and do a reply-to-all to that, adding suitable additional cc's *** Remember to use Documentation/process/submit-checklist.rst when testing your code *** The -mm tree is included into linux-next via various branches at git://git.kernel.org/pub/scm/linux/kernel/git/akpm/mm and is updated there most days ------------------------------------------------------ From: SeongJae Park Subject: Docs/admin-guide/mm/damon/usage: update stats update process for refresh_ms Date: Sun, 18 Jan 2026 10:02:57 -0800 DAMOS stats on sysfs was only manually updated. Recent addition of 'refresh_ms' knob enabled periodic and automated updates of the stats. The document for stats update process is not updated for the change, however. Update. Link: https://lkml.kernel.org/r/20260118180305.70023-7-sj@kernel.org Signed-off-by: SeongJae Park Cc: David Hildenbrand Cc: Jonathan Corbet Cc: Liam Howlett Cc: Lorenzo Stoakes Cc: Michal Hocko Cc: Mike Rapoport Cc: Suren Baghdasaryan Cc: Vlastimil Babka Signed-off-by: Andrew Morton --- Documentation/admin-guide/mm/damon/usage.rst | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) --- a/Documentation/admin-guide/mm/damon/usage.rst~docs-admin-guide-mm-damon-usage-update-stats-update-process-for-refresh_ms +++ a/Documentation/admin-guide/mm/damon/usage.rst @@ -549,10 +549,13 @@ online analysis or tuning of the schemes The statistics can be retrieved by reading the files under ``stats`` directory (``nr_tried``, ``sz_tried``, ``nr_applied``, ``sz_applied``, ``sz_ops_filter_passed``, ``qt_exceeds``, ``nr_snapshots`` and -``max_nr_snapshots``), respectively. The files are not updated in real time, -so you should ask DAMON sysfs interface to update the content of the files for -the stats by writing a special keyword, ``update_schemes_stats`` to the -relevant ``kdamonds//state`` file. +``max_nr_snapshots``), respectively. + +The files are not updated in real time by default. Users should ask DAMON +sysfs interface to periodically update those using ``refresh_ms``, or do a one +time update by writing a special keyword, ``update_schemes_stats`` to the +relevant ``kdamonds//state`` file. Refer to :ref:`kdamond directory +` for more details. .. _sysfs_schemes_tried_regions: _ Patches currently in -mm which might be from sj@kernel.org are mm-damon-core-introduce-nr_snapshots-damos-stat.patch mm-damon-core-introduce-nr_snapshots-damos-stat-fix.patch mm-damon-sysfs-schemes-introduce-nr_snapshots-damos-stat-file.patch docs-mm-damon-design-update-for-nr_snapshots-damos-stat.patch docs-admin-guide-mm-damon-usage-update-for-nr_snapshots-damos-stat.patch docs-abi-damon-update-for-nr_snapshots-damos-stat.patch mm-damon-update-damos-kerneldoc-for-stat-field.patch mm-damon-core-implement-max_nr_snapshots.patch mm-damon-sysfs-schemes-implement-max_nr_snapshots-file.patch docs-mm-damon-design-update-for-max_nr_snapshots.patch docs-admin-guide-mm-damon-usage-update-for-max_nr_snapshots.patch docs-abi-damon-update-for-max_nr_snapshots.patch mm-damon-core-add-trace-point-for-damos-stat-per-apply-interval.patch mm-damon-tests-core-kunit-add-test-cases-for-multiple-regions-in-damon_test_split_regions_of-fix.patch mm-damon-core-introduce-active-memory-ratio-damos-quota-goal-metric.patch mm-damon-sysfs-schemes-support-damos_quota_active_mem_bp.patch docs-mm-damon-design-document-damos_quota_active_mem_bp.patch mm-damon-paddr-activate-damos_lru_prio-targets-instead-of-marking-accessed.patch mm-damon-lru_sort-consider-age-for-quota-prioritization.patch mm-damon-lru_sort-support-young-page-filters.patch docs-admin-guide-mm-damon-lru_sort-document-filter_young_pages.patch mm-damon-lru_sort-support-active-inactive-memory-ratio-based-auto-tuning.patch mm-damon-lru_sort-support-active-inactive-memory-ratio-based-auto-tuning-fix.patch docs-admin-guide-mm-damon-lru_sort-document-active_mem_bp-parameter.patch mm-damon-lru_sort-add-monitoring-intervals-auto-tuning-parameter.patch docs-admin-guide-mm-damon-lru_sort-document-intervals-autotuning.patch mm-damon-core-implement-damon_kdamond_pid.patch mm-damon-sysfs-use-damon_kdamond_pid.patch mm-damon-lru_sort-use-damon_kdamond_pid.patch mm-damon-reclaim-use-damon_kdamond_pid.patch mm-damon-hide-kdamond-and-kdamond_lock-of-damon_ctx.patch mm-vma-temporary-build-fix.patch selftests-damon-sysfs_memcg_path_leaksh-use-kmemleak.patch selftests-damon-wss_estimation-test-for-up-to-160-mib-working-set-size.patch selftests-damon-access_memory-add-repeat-mode.patch selftests-damon-wss_estimation-ensure-number-of-collected-wss.patch selftests-damon-wss_estimation-deduplicate-failed-samples-output.patch mm-damon-remove-damon_operations-cleanup.patch mm-damon-core-cleanup-targets-and-regions-at-once-on-kdamond-termination.patch mm-damon-core-cancel-damos_walk-before-damon_ctx-kdamond-reset.patch mm-damon-core-process-damon_call_control-requests-on-a-local-list.patch mm-damon-document-damon_call_control-dealloc_on_cancel-repeat-behavior.patch mm-damon-core-rename-damos_filter_out-to-damos_core_filter_out.patch mm-damon-rename-damon_min_region-to-damon_min_region_sz.patch mm-damon-rename-min_sz_region-of-damon_ctx-to-min_region_sz.patch docs-mm-damon-index-simplify-the-intro.patch docs-mm-damon-design-link-repology-instead-of-fedora-package.patch docs-mm-damon-design-document-damon-sample-modules.patch docs-mm-damon-design-add-reference-to-damon_stat-usage.patch docs-admin-guide-mm-damon-usage-introduce-damon-modules-at-the-beginning.patch docs-admin-guide-mm-damon-usage-update-stats-update-process-for-refresh_ms.patch docs-mm-damon-maintainer-profile-fix-wrong-maitnainers-section-name.patch docs-mm-damon-maintainer-profile-remove-damon-tests-perf-suggestion.patch