From patchwork Sat Sep 16 02:09:44 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 13388077 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 CBCC0CD37B0 for ; Sat, 16 Sep 2023 02:10:20 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 9C74C6B0414; Fri, 15 Sep 2023 22:10:12 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 9500B6B0415; Fri, 15 Sep 2023 22:10:12 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 7A3A36B0417; Fri, 15 Sep 2023 22:10:12 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0017.hostedemail.com [216.40.44.17]) by kanga.kvack.org (Postfix) with ESMTP id 653026B0414 for ; Fri, 15 Sep 2023 22:10:12 -0400 (EDT) Received: from smtpin13.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay08.hostedemail.com (Postfix) with ESMTP id 2F6BA140750 for ; Sat, 16 Sep 2023 02:10:12 +0000 (UTC) X-FDA: 81240830664.13.FEBE754 Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by imf26.hostedemail.com (Postfix) with ESMTP id 85E64140010 for ; Sat, 16 Sep 2023 02:10:10 +0000 (UTC) Authentication-Results: imf26.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=RR9Frdag; dmarc=pass (policy=none) header.from=kernel.org; spf=pass (imf26.hostedemail.com: domain of sj@kernel.org designates 139.178.84.217 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=1694830210; 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=6pNj0CnoGzD0fQaKrPUYN1YOnP92rgY7USykiRLR1k8jo8o9vfXYMC5188EuKgxNPcsUqk 2aG1yDWFhBPEZ19CuhVD3AcdgpoLg4OU51oIpt3Y8zVqAHDSQ1WMxSPeDx933y1tQVxE1f BE7HgBBc+6xpaZ+rEDdx4Ca5CksSOFQ= ARC-Authentication-Results: i=1; imf26.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=RR9Frdag; dmarc=pass (policy=none) header.from=kernel.org; spf=pass (imf26.hostedemail.com: domain of sj@kernel.org designates 139.178.84.217 as permitted sender) smtp.mailfrom=sj@kernel.org ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1694830210; a=rsa-sha256; cv=none; b=eVJtj6nJ+4fDtBEzqxAGyrEXBuD65eBZBVwVn0APbRSmQABfJOjUZ450fldv4d70vtLBcB Ap5SDvV5kHOQtCTjc2g4KpphQUt8Auu9AcRQBeDiZfWnkifz8rsNme+bGluHvu84O1S0Gg uGTA5jC/hr/dIwjoiBK0+ucvVm5JphY= 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 dfw.source.kernel.org (Postfix) with ESMTPS id B7CDF620ED; Sat, 16 Sep 2023 02:10:09 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 7E569C433C7; Sat, 16 Sep 2023 02:10:08 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1694830209; bh=mFM51HzoacyqEH6SUQlgy6Seux4I2scRhn39ZTi26N8=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=RR9FrdagkAthQDZzU/MqLOXvaeDFzI76AyKnmNaANhjKl5qK562b8z09HGpclirta jYc6LhrAJdUrtF6/8jEUYFxkzhz4DQs0wM8OIqyrP6MuYh5q8fsrOCkAhZ8cDkRDL+ m68G1t0/aauOfr5qF8XtuEjYHQmFewU+Siz5iH7DwXksWnvKxs++VqIl9SDSLjoUoY 0QdXTO1VgnyGAGXCuhbJxMUqcWGdICS6t8Md21tTKIOimgBmf0pSxHXMHOvbu2Sjsc As4vL2HJ+p/l6ENXnlhs5iHasOdBcHl2cwXlMbhtQReq+p8GnBNOXcxmZ4rOV/Zo9t 87jyj74Sod1Gg== From: SeongJae Park To: Andrew Morton Cc: SeongJae Park , Jonathan Corbet , damon@lists.linux.dev, linux-mm@kvack.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH 8/9] Docs/admin-guide/mm/damon/usage: update for DAMOS apply intervals Date: Sat, 16 Sep 2023 02:09:44 +0000 Message-Id: <20230916020945.47296-9-sj@kernel.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20230916020945.47296-1-sj@kernel.org> References: <20230916020945.47296-1-sj@kernel.org> MIME-Version: 1.0 X-Rspam-User: X-Stat-Signature: 4d5yay9nexqdkyqu8s9ihaydoia1quzt X-Rspamd-Server: rspam07 X-Rspamd-Queue-Id: 85E64140010 X-HE-Tag: 1694830210-566863 X-HE-Meta: U2FsdGVkX198wDnf0WId88B7XTostjOO4om9EPtdd8p4yiK5Qkoy3EnqIZuwFRE+7tBBHlHRTQa/2aFc/OS+kjxvwLerMops330jfsN4qrzzpbQ84lveoffz9eGF+E47qIBP6fK++JZwL3PGYDm585dFT8jGpnSBr6jKgGhKulIYauhhyoFZdzzK2VtPQfj3JAm5ROLsuAOE6w5l20THmSnTSNO5IM55qzP+UaAusUR8ECX1XcVtwbWgBFTxAE2JFnetzt4tz/bX9hF1p1dh/DWH5iVytH6P8HaitI+KceAR2sWyrIcINSwtW4wPO66BQFtg+ZK6pWNzTWhSjKIGrXnKQF174onjMZzRlv1sTC4pApRE5OdXdBhXhHzm+OyfNefySCjbHmMZx4seU9ELDXj0otxhG6xb2b8NjcZVIt+rHwnyYVA980ySLhPEURSXBQTTfJM9De1AQ4TXKEh51uR+4cnW2ZwjltOn7rqOpuEKKFzQo2/Kw9TaKMghi8l8U+SEsevI9nVFdUvEEkiHm6CIYHWDdQLZ3Cr8EFzpMngkE6+wxCw53EeF749PpL0U4T4tSKZr6TdZz/W1dvWs+nR6bgVHOeutvQedhmenNGqBEMa1QliBZJtPsX1IPPNBhF7PGqFritaUUhUJZzeHayVXXPiMgvX1hLfYSArNV2Ri6MsD2oUyv8MJjmawJuXsLNXMhO4TcHUyOZSdbMFcUkBbQ0XJigeksxA01Lc0WKyX7ZtGGbVbSi/XDBT6q8PbECCP9QcHx3OE8pf9P0bouN962HpOwq0W8O4Zb+Wlr6Yu7CyS4KVkDL8rMoJRR59sMyv0WuVM0oBAyGxQ/8/kf2KQ68wfQ6a6NK1EXiEdtIZnDRXo8T6t11V0jVQjG1J54xnHjErUNudbmQ76+GTDMaMMzV06WotZv3lF6jPbMlpAOWbhckrrMzOtgbJ3aOdk658h/vpz3e17G9+hwxr P9sHlyh4 MwaqBqX8Ofg7Df1MQThN3ya3YpCBrDLpRAHjItaGN1cH1aq8x+9yWt90XV0/1IcgUd7MPRk1tP5qwaOX4Rp085Vy40lFEgdQQ91iNcqY8VP7mx3BMtjPCPuUfj1D1zJxkAJOqXR1JyjZWrK1h7ZTMHdyR7sYRsq1Z4FU4+OqyGK0o4U3rCd78oiFOfXCb8Y4VILusrCYDlJy4qSHLmd9G0qexCXMaSkrRTwOji4xxe1KxXLUPcSEckB8CSLsqxJ9fCCTitrW89O+amARTLnB6uYSxTdP7Xw8ZllhSr2EUYFy4xuNwzPq6Jzbp6PJyy18gktVx2qdwZItxaHhFvHDN4xSYf5mSErBI+j0u 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: 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/ ---------------------------