From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by smtp.lore.kernel.org (Postfix) with ESMTP id 8980FC83F1B for ; Thu, 17 Jul 2025 05:55:07 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 1D8796B00A3; Thu, 17 Jul 2025 01:55:01 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 1B07B6B00A5; Thu, 17 Jul 2025 01:55:01 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 0EDD96B00A8; Thu, 17 Jul 2025 01:55:01 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0010.hostedemail.com [216.40.44.10]) by kanga.kvack.org (Postfix) with ESMTP id F16936B00A3 for ; Thu, 17 Jul 2025 01:55:00 -0400 (EDT) Received: from smtpin02.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay02.hostedemail.com (Postfix) with ESMTP id A5D1112DEF7 for ; Thu, 17 Jul 2025 05:55:00 +0000 (UTC) X-FDA: 83672693160.02.A062322 Received: from sea.source.kernel.org (sea.source.kernel.org [172.234.252.31]) by imf02.hostedemail.com (Postfix) with ESMTP id EFBBD80005 for ; Thu, 17 Jul 2025 05:54:58 +0000 (UTC) Authentication-Results: imf02.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=sqcjhw6G; dmarc=pass (policy=quarantine) header.from=kernel.org; spf=pass (imf02.hostedemail.com: domain of sj@kernel.org designates 172.234.252.31 as permitted sender) smtp.mailfrom=sj@kernel.org ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1752731699; a=rsa-sha256; cv=none; b=qqN9rCTy24wvKS7Ng+LVMlxE23OBs3B8euqbKVoZGBTUdWcKTLgLIYfJyWftcq60wcbdx4 g7jR07zI39u8q/V++zmnEy9hkv0bI/ZgNSRggwbtPsntEIExhKrhMn0B3yeGASmecXQQby SekkQDRjqGh7VnZOlMriafv4o/lcEP8= ARC-Authentication-Results: i=1; imf02.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=sqcjhw6G; dmarc=pass (policy=quarantine) header.from=kernel.org; spf=pass (imf02.hostedemail.com: domain of sj@kernel.org designates 172.234.252.31 as permitted sender) smtp.mailfrom=sj@kernel.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1752731699; h=from:from:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=LiU6wJKC8bqWOQFWyNzqmzKJ0iiNADVYhWNGZYSjjU4=; b=S+GOwiLoyWQooL2mdSUk07xr0eDSvgZ/sKhyDASzpSJG+RN8ftaCWnqQdx6R7zi3mOk45+ SqyT6jw5whIyAxOLC5nZ1XSSdAnifI/TxCbkQHHJKX124jVFB2jhU3pdXZWXiNyMF9xcZK 4WXf1bppofyz+o5UpBPmNT+BGweM6yc= Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by sea.source.kernel.org (Postfix) with ESMTP id F23754661B; Thu, 17 Jul 2025 05:54:57 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id AF790C4CEE3; Thu, 17 Jul 2025 05:54:57 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1752731697; bh=oDJKqZFFqV/IVUvVAZh+/YozTjWBAbZi/gNGteq41Is=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=sqcjhw6GVDPq42JmF+087KxOshGgfz/uX4ZEkd92PHdTye6Dte6ITWRxIUIkHmP2m hvXmTElpj7rffA10WZL8HMFNChZeWOUvOhos/xUZ84Qns899/LnmJso1h+yPaqu9J0 rF1JPP/2eS9HRUpbmZ38+4l620kuqu+bVLGe/t0K1cuR0wB+5oyf3xBZNYI0VOIO7R iTyozrcfh0gozmotU4IwgOcLK0hyIMnf++HlwogjsoS4VIkEOOn4awtRS+o2LWrZ1b QxM0c85JhmUPF9GxZb4GBgJxoKGVINUbSm+ksgeRAls8+u4e3KBk2/pKg4I0gIK9Wl VFPt9ZcVNUABA== From: SeongJae Park To: Andrew Morton Cc: SeongJae Park , Jonathan Corbet , damon@lists.linux.dev, kernel-team@meta.com, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-mm@kvack.org Subject: [PATCH 3/4] Docs/admin-guide/mm/damon/usage: document refresh_ms file Date: Wed, 16 Jul 2025 22:54:47 -0700 Message-Id: <20250717055448.56976-4-sj@kernel.org> X-Mailer: git-send-email 2.39.5 In-Reply-To: <20250717055448.56976-1-sj@kernel.org> References: <20250717055448.56976-1-sj@kernel.org> MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Rspamd-Queue-Id: EFBBD80005 X-Stat-Signature: r8o1xarxrcgxmcs98p81frzwoxxmpsaa X-Rspam-User: X-Rspamd-Server: rspam08 X-HE-Tag: 1752731698-402469 X-HE-Meta: U2FsdGVkX1+NNcuczFcAu9y/mqWnG/4e/uXzAilLr4hsCJnFOUr1Y2cuVFf29kbu+XwEhH8a9Tj3DcobaNb7h2g1nBIUDunoZ3AClnL81M0wVmWigmjkLC582jqdErKO70fqteHPAJ4OhI+5RDTSGG12H5fsNgpteayBFRchxEwBvLo7//tQ7Hq32I6zAF4UQSM9oDLLgghTXbsAaID9xBoyOIR3a0HZewILgSESQNW0JpeQxLx6Ye2z9Z7huoSi74DwHO7+/ZFFo3s4S94JHAv9dRuShNRelTYCvFRaTKf5wi3nEc1ULA8MdRJpw2LoVXi+3HXWRPLhwZJ05nza2CMdPf2evjzkCJDthvoZRN4pODSXtJYTOzMXFGB/ogs9OXblxC6nNHXc2pZDxvhU5pFlmfKZcrbxaGT4pcayPlvtSAsrEMSoMyZ/7DoflIna8z39KWpHyjgQY6X4HL74c4Y7suf640YBSHjnYYRnUxchXkuCz6eImGTX82B8oCmGImU1Nq55hYy/cz235zmUWlBcLhKP0lv4FpzDcUaJECppxFM+qbehzyiaJ1Wp9V4ZcB1aNGPZc2UWcXmci6HgDqUSN2p5XhDfDkTa/JlP4kURUzMb/4J2U6uSqwXsnO2uGJ6M8nrPiWQjeo4dxJ6GRfhT2fktR33DXAAzpdHhXALwu2ZeUpsNIe5yU65iHwaH9Mll9oRDeUug7xazDPw0PUs5Z3/jJgSZOgCCQlUqCq5cyJb9jCJJMKxFEJyQIU9b40Q/cZxoaeYX6fS/n9dVhJYMjDU7EhIU7W1yRWDGHhsejsrK1SRPqfLrJn62gkxM5UrlaaUurOoeRUE1D+dN2tLR2F/Zrqhm2ZszPayg/l/Vr08teQjfyLXt9gs1LDhoeOoSGwUhJZiLMecq2XDtLsrGTYyrAvBCQ3f0A3NDTC1auccqqgBJXp28/M0m4uRCsDYQzw/N6NEgnwY90Pg 1pqzIms2 RBx4rIxJo3WAGpGk8AouMhB7Ds77YdiZ3/PwwaA8Zq7NKJ0PN8s9Ne2HvC8tmiVWV0Lcnkz7nNSqYK6jR7Qf8lwP20L7jZ5DzsVUSOFYb6fuq+MRSyIEi1PxpXS4vyjcvwzQeMo0cBsScpWnstKIsW9H7cwyg1jxmHTYvjse1BT6Xxn4XeWbYBax2i4ZG4ae7bH0KhvTAddTia3dOd9DzGHfECYdQSs5MMF2bsBfaAfJS4WkrcOtRKgi3W6x5q4fEX5TP/KvLkhGSooFtOI1HWmt6XLzLp16PsrEKSnzc9Yb5bjGBtKTRsYOgL8KSYU80vaUolvduiduB+jSBVERiA51vDate5jBdw/lm X-Bogosity: Ham, tests=bogofilter, spamicity=0.000000, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: List-Subscribe: List-Unsubscribe: Document the new DAMON sysfs file, refresh_ms, on the usage document. Signed-off-by: SeongJae Park --- Documentation/admin-guide/mm/damon/usage.rst | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/Documentation/admin-guide/mm/damon/usage.rst b/Documentation/admin-guide/mm/damon/usage.rst index fc5c962353ed..ff3a2dda1f02 100644 --- a/Documentation/admin-guide/mm/damon/usage.rst +++ b/Documentation/admin-guide/mm/damon/usage.rst @@ -59,7 +59,7 @@ comma (","). :ref:`/sys/kernel/mm/damon `/admin │ :ref:`kdamonds `/nr_kdamonds - │ │ :ref:`0 `/state,pid + │ │ :ref:`0 `/state,pid,refresh_ms │ │ │ :ref:`contexts `/nr_contexts │ │ │ │ :ref:`0 `/avail_operations,operations │ │ │ │ │ :ref:`monitoring_attrs `/ @@ -123,8 +123,8 @@ kdamond. kdamonds// ------------- -In each kdamond directory, two files (``state`` and ``pid``) and one directory -(``contexts``) exist. +In each kdamond directory, three files (``state``, ``pid`` and ``refresh_ms``) +and one directory (``contexts``) exist. Reading ``state`` returns ``on`` if the kdamond is currently running, or ``off`` if it is not running. @@ -161,6 +161,13 @@ Users can write below commands for the kdamond to the ``state`` file. If the state is ``on``, reading ``pid`` shows the pid of the kdamond thread. +Users can ask the kernel to periodically update files showing auto-tuned +parameters and DAMOS stats instead of manually writing +``update_tuned_intervals`` like keywords to ``state`` file. For this, users +should write the desired update time interval in milliseconds to ``refresh_ms`` +file. If the interval is zero, the periodic update is disabled. Reading the +file shows currently set time interval. + ``contexts`` directory contains files for controlling the monitoring contexts that this kdamond will execute. -- 2.39.5