From patchwork Wed Apr 16 04:25:50 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 14053153 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 76C4CC369B1 for ; Wed, 16 Apr 2025 04:26:21 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 3BBBC6B025A; Wed, 16 Apr 2025 00:26:07 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 365F36B025B; Wed, 16 Apr 2025 00:26:07 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 13E7D6B025C; Wed, 16 Apr 2025 00:26:07 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0014.hostedemail.com [216.40.44.14]) by kanga.kvack.org (Postfix) with ESMTP id E6D976B025A for ; Wed, 16 Apr 2025 00:26:06 -0400 (EDT) Received: from smtpin15.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay10.hostedemail.com (Postfix) with ESMTP id 67F5DC1A12 for ; Wed, 16 Apr 2025 04:26:08 +0000 (UTC) X-FDA: 83338619616.15.C525230 Received: from nyc.source.kernel.org (nyc.source.kernel.org [147.75.193.91]) by imf19.hostedemail.com (Postfix) with ESMTP id 049411A0006 for ; Wed, 16 Apr 2025 04:26:06 +0000 (UTC) Authentication-Results: imf19.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=N7en+Pxz; dmarc=pass (policy=quarantine) header.from=kernel.org; spf=pass (imf19.hostedemail.com: domain of sj@kernel.org designates 147.75.193.91 as permitted sender) smtp.mailfrom=sj@kernel.org ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1744777567; a=rsa-sha256; cv=none; b=GlI8z/rvrvlpc37AvJanjMVPvkfg8+qIvBDxlKEFD4/Hh9YuqZ+X5nFk7SQWMH4wixwK6X o9EiRhQGfX3DN9bRkJe5ULfteWwbK77sdaoxGusm+JimOpYEYo0nr3MaK3HILcuIdT1jW+ 33BSsxvn+BZgk2xd2EepLjA1flePXro= ARC-Authentication-Results: i=1; imf19.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=N7en+Pxz; dmarc=pass (policy=quarantine) header.from=kernel.org; spf=pass (imf19.hostedemail.com: domain of sj@kernel.org designates 147.75.193.91 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=1744777567; 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=BdTFi/QFfmbxCgHbmhoHF1yfo+I2CxnEpHxhFOhdTOE=; b=VWs+/bVDFAerlvTwHOPmx+NlsRhWURe1QdIU9AQmEWcn+YEmvyucjeRs1dqcMtdn54qDVV WxenbX28EXrcwxiLHJ4CB9KPCEUM6dYRJtlRgTUCsQhsBewv46XqBfjRuJDx3tZSUS0CSJ fkcMC/XHbbb+voC9FzLFcMeMmUBqiH4= Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by nyc.source.kernel.org (Postfix) with ESMTP id 23E81A4AFFF; Wed, 16 Apr 2025 04:20:38 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 272B2C4CEEC; Wed, 16 Apr 2025 04:26:06 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1744777566; bh=gTYFPTKVeiLrjsKHoO4pSEKq3DJORWxzfKSpIOcjMaE=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=N7en+PxzKcRRBHhvIXSVBYX4N8Bj1OKXNXS8nTBkNWMQj5EReGiWsYxV8RwCa9tW6 q4SgY+Nx+cY0eXA2ZvMO59Z48LSeusitAqVSZQ71qEYjjZyc8Kgonqu6oGyzeryiay g72OkIXWCh+D5RZeQcJFPOV8Rz+c7wTNyyzbQV7EbtLecxqZZ43B07MhDlg5L5vdis hCyFup72ae3K051TFjWIjIAtbtUJlBeWwRvCqumQn5lbVJXG5Wa4pXQ7qq8nlUeyhs p+gUDjcK1iwOh9W+gq5vmidX8V/Fmh+V4xnq4YJ1FwyySeaFzsLUJqH2oaUUtynzbO PSrUmikBoky7A== From: SeongJae Park To: Cc: SeongJae Park , Andrew Morton , Jonathan Corbet , Ze Zuo , damon@lists.linux.dev, kernel-team@meta.com, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-mm@kvack.org Subject: [RFC PATCH 09/10] Docs/admin-guide/mm/damon/usage: document addr_unit file Date: Tue, 15 Apr 2025 21:25:50 -0700 Message-Id: <20250416042551.158131-10-sj@kernel.org> X-Mailer: git-send-email 2.39.5 In-Reply-To: <20250416042551.158131-1-sj@kernel.org> References: <20250416042551.158131-1-sj@kernel.org> MIME-Version: 1.0 X-Rspamd-Server: rspam10 X-Rspamd-Queue-Id: 049411A0006 X-Stat-Signature: atyb93u76fuz16oazmzksf5w4gtbyry6 X-Rspam-User: X-HE-Tag: 1744777566-749611 X-HE-Meta: U2FsdGVkX18+GVyxoBSyCWIPsScX1CoPGGcLHlx7PILY86IRrnnaBHZSUhjXoDiBRSXyEKjvvpP9NlReK7EG+KNZOJyxKN7cAMPXeGnGbg9ByxMPC9f2divbcBaRMNyeQnYU3j9x23KPSzGHdp7R2hy6qJrSaE//hwQDTpRtq4KPP1B5lj8SJoungpHsoqcN4hiPh9Kux6pPevjt9uyn/f7uWitOIQaurA42cy5gI3NNl5X0jaIpKgd76U0HfIwFidznqWDfG2vHJcvF1UMAKf0a1dFVHQRYKLdGmIz7ANVtp4lEM2H4kwqVw+yZWTSBE4cZeSiA4seDPMGYVGiVlM8RbHkNXfsiET3EphYfdwvUQ+5T7ODhzU0sIsiPcdrBICluaS3KJNI1UaiEVyAPaJrWV8r+cjXoftZhnJxS9b/dce4Y3JGWasveuEUo44U2hzRWpIOGl8VNxb6seHSXg2zXI9p8nIammL7+44LU3jJCziQj/nAhW0LRnHZUBB0zVqxDg55ctySqea6DOIQESvmO7y1i1SDq42cSss9SdxQc0wnXQKGwNMLzzOIwgW17JnEI0nlzAMWQraV+iJyNXW9FGl1quDIC0ngu7oH1jkYUHlasPBrqWmasPdCQ00skxfQbVIN4/lhGwTcy92T6fX4WLXUp1dhaEmm5MB6zRfA9Z99VyRliUhT/8z/nrKkGGtFatIn6c5v9w9dSJsmvf7lGlMCAw/8RtVn1x9KX1o+U3wjlRp8j9CAQnVUPTsGZCoJv9Daa8KVkRzT3wh1xtALlE/bd26ZJw+1RJXRp9L4rF8dG9ggweN7YyrERzxVtozfO+deTNTeRFOvh8Wsy71YyRpS7OEEjqYjQE03oJGdeqaLUAJyYtXAMF0xBhMXd92J8nXeokLfCbnM4fC/w8AnypgiLwy/JrhCPOMeOFFj35QExdGFLG0FR07k1sFc+ X-Bogosity: Ham, tests=bogofilter, spamicity=0.000001, 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 addr_unit DAMON sysfs file on DAMON usage document. Signed-off-by: SeongJae Park --- Documentation/admin-guide/mm/damon/usage.rst | 11 +++++++---- Documentation/mm/damon/design.rst | 2 ++ 2 files changed, 9 insertions(+), 4 deletions(-) diff --git a/Documentation/admin-guide/mm/damon/usage.rst b/Documentation/admin-guide/mm/damon/usage.rst index ced2013db3df..7638bbaf9939 100644 --- a/Documentation/admin-guide/mm/damon/usage.rst +++ b/Documentation/admin-guide/mm/damon/usage.rst @@ -61,7 +61,7 @@ comma (","). │ :ref:`kdamonds `/nr_kdamonds │ │ :ref:`0 `/state,pid │ │ │ :ref:`contexts `/nr_contexts - │ │ │ │ :ref:`0 `/avail_operations,operations + │ │ │ │ :ref:`0 `/avail_operations,operations,addr_unit │ │ │ │ │ :ref:`monitoring_attrs `/ │ │ │ │ │ │ intervals/sample_us,aggr_us,update_us │ │ │ │ │ │ │ intervals_goal/access_bp,aggrs,min_sample_us,max_sample_us @@ -179,9 +179,9 @@ details). At the moment, only one context per kdamond is supported, so only contexts// ------------- -In each context directory, two files (``avail_operations`` and ``operations``) -and three directories (``monitoring_attrs``, ``targets``, and ``schemes``) -exist. +In each context directory, three files (``avail_operations``, ``operations`` +and ``addr_unit``) and three directories (``monitoring_attrs``, ``targets``, +and ``schemes``) exist. DAMON supports multiple types of :ref:`monitoring operations `, including those for virtual address @@ -196,6 +196,9 @@ You can set and get what type of monitoring operations DAMON will use for the context by writing one of the keywords listed in ``avail_operations`` file and reading from the ``operations`` file. +``addr_unit`` file is for setting and getting the :ref:`address unit +` parameter of the operations set. + .. _sysfs_monitoring_attrs: contexts//monitoring_attrs/ diff --git a/Documentation/mm/damon/design.rst b/Documentation/mm/damon/design.rst index 696a4d738cb3..56bfc0abff36 100644 --- a/Documentation/mm/damon/design.rst +++ b/Documentation/mm/damon/design.rst @@ -137,6 +137,8 @@ the interference is the responsibility of sysadmins. However, it solves the conflict with the reclaim logic using ``PG_idle`` and ``PG_young`` page flags, as Idle page tracking does. +.. _damon_design_addr_unit: + Address Unit ------------