From patchwork Sun Sep 10 03:40:47 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 13378445 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 36803EEB57D for ; Sun, 10 Sep 2023 03:41:10 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 54EAA6B012E; Sat, 9 Sep 2023 23:41:02 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 4FCF66B012D; Sat, 9 Sep 2023 23:41:02 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 378876B012E; Sat, 9 Sep 2023 23:41:02 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0015.hostedemail.com [216.40.44.15]) by kanga.kvack.org (Postfix) with ESMTP id 207BA6B012C for ; Sat, 9 Sep 2023 23:41:02 -0400 (EDT) Received: from smtpin21.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay07.hostedemail.com (Postfix) with ESMTP id F40F01607CD for ; Sun, 10 Sep 2023 03:41:01 +0000 (UTC) X-FDA: 81219286722.21.89388C8 Received: from sin.source.kernel.org (sin.source.kernel.org [145.40.73.55]) by imf14.hostedemail.com (Postfix) with ESMTP id E9183100009 for ; Sun, 10 Sep 2023 03:40:59 +0000 (UTC) Authentication-Results: imf14.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=ggjMC2rm; spf=pass (imf14.hostedemail.com: domain of sj@kernel.org designates 145.40.73.55 as permitted sender) smtp.mailfrom=sj@kernel.org; dmarc=pass (policy=none) header.from=kernel.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1694317260; 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=pn6oOlASxZHN7mPKejPZwPvUfkQcqx14txayV6bXunQ=; b=nttg1rG/xV1imVxg3VUE96GibRxGzyz9y5al/1kx1jCFOAsB4jz0AqGA1h0n56RsmJU0tX FPoizklesF5/trHMdXrCFqUmbxWyMsKGqJ11MUjJFz5X8N6C2caU5Yl8aNLQUWKh1AOuCU eIV/ImeAl7i5C27NHkzCDE7PE/3I3+o= ARC-Authentication-Results: i=1; imf14.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=ggjMC2rm; spf=pass (imf14.hostedemail.com: domain of sj@kernel.org designates 145.40.73.55 as permitted sender) smtp.mailfrom=sj@kernel.org; dmarc=pass (policy=none) header.from=kernel.org ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1694317260; a=rsa-sha256; cv=none; b=mK5f0+V40yD44Li7gMrGeJJ5m6ch7OEMh+ZOuBBor7ciw44QpIMlQ4QrQnWiXlxTu6DWT3 Jrw8yzKCpYmqQvlhFrbc2MPgHcoEGOZALmyKxJPk3zyWLF77fWsjGYXn+VxxjsutALSm6G gr5hD2vEXWpEu4zi2qrygFaz8W09l3M= Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits)) (No client certificate requested) by sin.source.kernel.org (Postfix) with ESMTPS id 610B0CE0A2B; Sun, 10 Sep 2023 03:40:56 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 7BCC7C433CB; Sun, 10 Sep 2023 03:40:55 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1694317256; bh=mFM51HzoacyqEH6SUQlgy6Seux4I2scRhn39ZTi26N8=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=ggjMC2rmC/l0w3mnxmHmvMLHBY+eoIkIhaqUHgcKJkeLp9KdJd9TOBud13T113lyx bK+9WVt2wR8tYBlSMiwDTbbJWBtR8c2uKMve4DoO47Ocw9i1LprtBLoEe8R1sVkRu6 QaVmD7Domx1Dhzr1xW9KHlMlM8CpgIkYhycXUCR1+xnrQy7lcckR7acPYU9lpf9ZKi 139vmPrd7zxFCh1zlOZ/eQoDhJMv/Ybu9j8+QqTtqcG/fUvso0W2tLBty1MDSUlTwy yyTYrg/FNIF/NEfT3QCrRkNG+qDMx2BtxTu2DvezLkq674bfGaS9kb86X/wN6Q68v5 MehGv6Co7gdAA== From: SeongJae Park To: Cc: SeongJae Park , Andrew Morton , Jonathan Corbet , damon@lists.linux.dev, linux-mm@kvack.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [RFC 7/8] Docs/admin-guide/mm/damon/usage: update for DAMOS apply intervals Date: Sun, 10 Sep 2023 03:40:47 +0000 Message-Id: <20230910034048.59191-8-sj@kernel.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20230910034048.59191-1-sj@kernel.org> References: <20230910034048.59191-1-sj@kernel.org> MIME-Version: 1.0 X-Rspamd-Queue-Id: E9183100009 X-Rspam-User: X-Stat-Signature: nxho6hmk18iimznpz6diyotxcbw37hmc X-Rspamd-Server: rspam01 X-HE-Tag: 1694317259-340814 X-HE-Meta: U2FsdGVkX1/8gGQbyCh8NH8WnjROfMuWP0Nudim8xQRrwa8zOpZHo0QjsrLVWHh6kkLW8bfzBslHp4goHIpA6AzQXj5Z2Gvz6AUKWI+oCD3s1KhSJsaM5IMMC+4kb2XWw+C+d5f3AIIsESHcH7TE3NgnJBMFqOFSCtheuSP5JkSHiK9u1puih3GZzcaUw38C/m0GA2OAVcM9ty0a8WIzxiEL9HRhf8+lLyTwYCdFtDe8LGSe8dBh4I3i6Dh6XFB55+RSAAZ3/GC8ngSfffwg32oaJSjR1Yecdz80SPN6LUcQDp7GPS/rzv+xp/ZzqeXCU+dh11ZAwBHJzYZk54JkN0nRNuEBRkFG4PKQR8/TY+379ic4gq4QtI4r/s/VY7TG9ii/wOCZ4roKDmlIf/GdxstS3M94PRrjwQvJbEqzSVP0redNjNkUbuW+RhD+QqjXcbM1xDVVcwJolqH1n8ZNEeok1W7B+1AmtSF5Fr3arOVtGiNzzLpxqpTr1g22RQEdUyr58DU3JYw9M9blmAM6JxzHaS1P2eIHrBZ3QufSUfPTlWHAIT/w876hPcaTEySHLe9wklvlwew5WYerpHyA3RPFVCPRD0vHdrVhfzIl13Q/+ga61395NHAGQkIM11M1To/Mic2rOlECcLLRr4IGaAzmUHtq9VyMJzb3keHkV88vG4IPvtCAuZmyNycnxOerD9u/JMyA8Qi5FLQhqhnaYIfFMZgrrjHDRDp8jZ34dqUfhQByRaAd7ZxO/0XAjS8OPdnFWlk6sB4Jyhph4yOvViaf944tz+fSJCLBMD1ZIHziDUxv0vHgvZjyXs+cwumOQ1vk/IoktSCZXNjDxck+hA7QFWuwJ0zPqS2GN7ZbTiLJ84ivRJFVVRTuyCePED28ek/jJrhnksczWkIGX3CIsf321B/rGA+H35MldOr3AVjhyuN3uyFt/yUCPif/3Cac03TXlyaxl5PvMnXFgHM NYibHgwN z0i9TVPo7UITEHcPUK0N6ukbUJUClQ7EbllIzvh+5roLdIQEOaO8c0CgtGMXXEDMo9mPfoXSFBIUkhC00t0Cq0Oxe36cbXYXAgGJES+4yEBJ1lDs90T7jd3XGxjA8/+9o7Tc+F24OYkFnx1Ti4zdbAQ1pqa6bijmgWtBdWKM+hXWgpWvCppTEKb46PoqS2mA/1AeJM76/ZcjbZJJnIfn2Vp53/qEXf0AVaT4e6hcXVsrUjgRlWy/QVP0x8qU0ickOOwp5aGkLrDll4khq1LZCvoFMofTPmnD5kK347Yk4FzGeRMGQA80H8GIPHbcXyECKwxouC0+Cq586XdtTXbyCghkJQQ== X-Bogosity: Ham, tests=bogofilter, spamicity=0.000073, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: Update DAMON usage document's DAMON sysfs interface section for the newly added DAMOS apply intervals support (apply_interval_us file). Signed-off-by: SeongJae Park --- Documentation/admin-guide/mm/damon/usage.rst | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/Documentation/admin-guide/mm/damon/usage.rst b/Documentation/admin-guide/mm/damon/usage.rst index 6272cd36590a..8507a6e45d86 100644 --- a/Documentation/admin-guide/mm/damon/usage.rst +++ b/Documentation/admin-guide/mm/damon/usage.rst @@ -76,7 +76,7 @@ comma (","). :: │ │ │ │ │ │ │ │ ... │ │ │ │ │ │ ... │ │ │ │ │ schemes/nr_schemes - │ │ │ │ │ │ 0/action + │ │ │ │ │ │ 0/action,apply_interval_us │ │ │ │ │ │ │ access_pattern/ │ │ │ │ │ │ │ │ sz/min,max │ │ │ │ │ │ │ │ nr_accesses/min,max @@ -269,8 +269,8 @@ schemes// ------------ In each scheme directory, five directories (``access_pattern``, ``quotas``, -``watermarks``, ``filters``, ``stats``, and ``tried_regions``) and one file -(``action``) exist. +``watermarks``, ``filters``, ``stats``, and ``tried_regions``) and two files +(``action`` and ``apply_interval``) exist. The ``action`` file is for setting and getting the scheme's :ref:`action `. The keywords that can be written to and read @@ -296,6 +296,9 @@ Note that support of each action depends on the running DAMON operations set - ``stat``: Do nothing but count the statistics. Supported by all operations sets. +The ``apply_interval_us`` file is for setting and getting the scheme's +:ref:`apply_interval ` in microseconds. + schemes//access_pattern/ ---------------------------