From patchwork Mon Jan 6 19:33:48 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 13927784 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 D12E6E77198 for ; Mon, 6 Jan 2025 19:34:16 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 35B326B009F; Mon, 6 Jan 2025 14:34:14 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 2E3796B00A0; Mon, 6 Jan 2025 14:34:14 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 164606B00A1; Mon, 6 Jan 2025 14:34:14 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0012.hostedemail.com [216.40.44.12]) by kanga.kvack.org (Postfix) with ESMTP id E1ADD6B009F for ; Mon, 6 Jan 2025 14:34:13 -0500 (EST) Received: from smtpin11.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay03.hostedemail.com (Postfix) with ESMTP id 96598A0215 for ; Mon, 6 Jan 2025 19:34:13 +0000 (UTC) X-FDA: 82978027986.11.2A5166B Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by imf27.hostedemail.com (Postfix) with ESMTP id 080794000F for ; Mon, 6 Jan 2025 19:34:11 +0000 (UTC) Authentication-Results: imf27.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=hzX2HhDR; spf=pass (imf27.hostedemail.com: domain of sj@kernel.org designates 139.178.84.217 as permitted sender) smtp.mailfrom=sj@kernel.org; dmarc=pass (policy=quarantine) header.from=kernel.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1736192052; 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-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=aNCasyy/zneJBDyynNUhI/AR7CR07gxi+f6WqfqE1/w=; b=7Aahtect8g4qKrb7vs5N6aCjzxeLyjp/ycj5/9H6X28IHQKQ35R4w5uRVaftLVgrtM8YXE 6T4IPfQbXfzvAHU+MiyQr5UCVOAHd/ZGuNTWf2ULOSmetxZYJvw4z/PfsjPjDTdS+OuwVV +hzv22Vv5OR1XeC8dgLe2bddfPBDTYM= ARC-Authentication-Results: i=1; imf27.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=hzX2HhDR; spf=pass (imf27.hostedemail.com: domain of sj@kernel.org designates 139.178.84.217 as permitted sender) smtp.mailfrom=sj@kernel.org; dmarc=pass (policy=quarantine) header.from=kernel.org ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1736192052; a=rsa-sha256; cv=none; b=3u1zNoEcJRfzHMIejJEqL0xKuFYv7SztpUaq+boswv1KHRsa7bas8N+eXhyjvzztD4HCPX bbq02WvJjWrHlGWVX6fPivwKUGnWoWse3GRN3z74i7JSY1ZkGlWewT9r/Gpp3i5wYac5uY Xby4Y3TVsgbk+i3Fc7TqgEx2WEc8h/c= Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by dfw.source.kernel.org (Postfix) with ESMTP id 2863D5C4A97; Mon, 6 Jan 2025 19:33:30 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id EA771C4CED6; Mon, 6 Jan 2025 19:34:10 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1736192051; bh=Xy/cUyoqUpo6pu4RY3ebUwHZ83NPf59O+4AQ8ljJSu0=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=hzX2HhDRRLJIqeA8n/fcBJWT8mLbmy7WeW8j7w+YR7dziXB43hzn8Tl5T9vie6eqD ApH3/H6fSmd0uMkiDSsZ9expdHg1DnXnEH0P09jE39nvIfEu/6Nku7XWF8dyHPgTRb 7XwwUV5kHNzmOA870z437dW8Rz3/NkosK5IPzMFYHB9A57gFkcia8z6aqVe6J7QT1D sRwQfVHdS+j6Ov9Da5PLbtO3IE73FzG87dy90bWrP1IwIu6AVlzfJD6feaZ3G01YrP 0Y8gorNksOqrG65TW4XhVftjjYOSOW5q4WptJ1ldr4ki/soXf4O6+G/EdFq+Enrsbg 4kXBHSgT1usZQ== From: SeongJae Park To: Andrew Morton Cc: SeongJae Park , Jonathan Corbet , damon@lists.linux.dev, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-mm@kvack.org Subject: [PATCH 03/16] Docs/admin-guide/mm/damon/usage: link damos stat design doc Date: Mon, 6 Jan 2025 11:33:48 -0800 Message-Id: <20250106193401.109161-4-sj@kernel.org> X-Mailer: git-send-email 2.39.5 In-Reply-To: <20250106193401.109161-1-sj@kernel.org> References: <20250106193401.109161-1-sj@kernel.org> MIME-Version: 1.0 X-Rspamd-Server: rspam05 X-Stat-Signature: wryry4uqtys1aemmpue4hsxyp18dzuta X-Rspamd-Queue-Id: 080794000F X-Rspam-User: X-HE-Tag: 1736192051-505777 X-HE-Meta: U2FsdGVkX1+Xksog0izWpCDnmXvHhHyld/gXYxSonsXfRZ3hCAthG2oebwZFZfes8ITfX8w07Gs519JWJxMCtbI2ARQdz0L4EzYbifw1aOx2t0ocoIQn5f9QuqNKjR26RcnglRCP1HDVtWMclLyfTBcBrU6wK5Qbd9iYO8c/GQr+PIcILFHNiMLzDyPyVHBmpLikSApu/x34zSfGHUy3wvkbG6AqVhj9ND0rHDjyJtelcDc+wlD0zLMWOUffHF5Y6FweCIOzEwdreG8PneOBKyeBlXd4cw3kXVK333rgi43D+7P66WVvyacotQwoRSjujikVgGztP0qNtTvrapjLL9MjbwDwYZ5hqEthCiCAlMQmXKPKhBOUp4sU7lUyUGGRFBktiMNapVCoi3QC0w47O11EMhTLV2X43xMZ9zDa/ITDdiYJ2SUdIyvdcg6ZvrssTcGTrJlqj7hEIVGr9jo7vS2gVY7J9A+kS3171ZMV0y/sH0Gxb1z6+POqtY5EOsaNilbQtz4Mp6UDCFUF+xCFCd8R4IY4IiVH83FTjGvQ1vZEyAR2lr4lr3DHYkrt+o8qvThD5KLCrSWNQk/yiPjMWObygTC08zAhJqUEcwjJvL30ikLmQFCJCypixlh2zhceRh4E2WFzkagygBSQzBAUa6ds+l0bPYVAI+ctepBBCbY7zCbjnsRFA9wneAr9o1DkonWY8lj0lFuKU4UxtyD1jPcbxoS8Jgpyj0fuGOnNUmo20FOzyaTbrCsLBR86IxsPUEWOJ+2aaJVYuD61f/+i5gZg7G/Dn4wPDKUC8VxBjV8TpBrJAzmGMOiOZmTp1TFRKisLvHob229NNse3y8O14O4SySaKMTE4gHRiBafPjQjXwA0m1cO6PCY8RcaB/gahJw13PK2v3iFHNVL7dU+Fg3OTf/yEmdZipiOfRXnuOoLaatAAw+UtKbboVEsbpIBjb4Yd1FYfFse2nwOvdk3 u6VbSI5X wDQ840Y3skgT6hEsFoeUzNBtNADXWJa9ag+i18KdRXzmOuFtYVnZByWvqnqYU0qfqMCxSmHV0saZINJpk76svRsNapLGVafJUKAlVip8iCV6/k7FxzxE6+dh3qQ+/MC3IoNCY2hUDKgYrG7T+KU/C09YVpM2Mix1OzfQnGRCP0fi4CN8ApmgVHnpsYpdT8zc3CheZ5F5ozwb8EA02MaFnsQGsJlNRhkOUfnZfAD47KYIRoZ6ppH9Kbp7nwaG4sXukqRmBuU3E+TdE4go= 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: DAMON sysfs usage document focuses on usage, rather than the detail of the stat metric itself. Add a link to the design document on DAMOS stat usage section. Signed-off-by: SeongJae Park --- Documentation/admin-guide/mm/damon/usage.rst | 3 ++- Documentation/mm/damon/design.rst | 2 ++ 2 files changed, 4 insertions(+), 1 deletion(-) diff --git a/Documentation/admin-guide/mm/damon/usage.rst b/Documentation/admin-guide/mm/damon/usage.rst index c685d87ea078..2e835c9bcfdf 100644 --- a/Documentation/admin-guide/mm/damon/usage.rst +++ b/Documentation/admin-guide/mm/damon/usage.rst @@ -451,7 +451,8 @@ schemes//stats/ DAMON counts the total number and bytes of regions that each scheme is tried to be applied, the two numbers for the regions that each scheme is successfully applied, and the total number of the quota limit exceeds. This statistics can -be used for online analysis or tuning of the schemes. +be used for online analysis or tuning of the schemes. Refer to :ref:`design +doc ` for more details about the stats. The statistics can be retrieved by reading the files under ``stats`` directory (``nr_tried``, ``sz_tried``, ``nr_applied``, ``sz_applied``, and diff --git a/Documentation/mm/damon/design.rst b/Documentation/mm/damon/design.rst index aa2e4694ee14..158d0a4e1d7f 100644 --- a/Documentation/mm/damon/design.rst +++ b/Documentation/mm/damon/design.rst @@ -539,6 +539,8 @@ To know how user-space can set the watermarks via :ref:`DAMON sysfs interface `, refer to :ref:`filters ` part of the documentation. +.. _damon_design_damos_stat: + Statistics ~~~~~~~~~~