From patchwork Thu Sep 7 02:29:22 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 13376097 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 12019EE14C3 for ; Thu, 7 Sep 2023 02:29:45 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 98CE5280022; Wed, 6 Sep 2023 22:29:43 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 8F0A7280029; Wed, 6 Sep 2023 22:29:43 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 5EB19280022; Wed, 6 Sep 2023 22:29:43 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0013.hostedemail.com [216.40.44.13]) by kanga.kvack.org (Postfix) with ESMTP id 457A8280027 for ; Wed, 6 Sep 2023 22:29:43 -0400 (EDT) Received: from smtpin28.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay06.hostedemail.com (Postfix) with ESMTP id 21119B42C1 for ; Thu, 7 Sep 2023 02:29:43 +0000 (UTC) X-FDA: 81208220646.28.850DD67 Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by imf18.hostedemail.com (Postfix) with ESMTP id 76EC41C000D for ; Thu, 7 Sep 2023 02:29:41 +0000 (UTC) Authentication-Results: imf18.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=ohoS0Q5N; spf=pass (imf18.hostedemail.com: domain of sj@kernel.org designates 139.178.84.217 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=1694053781; 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=vT0qqmzZ4R2b8Z6h3w2hqYqtimOoHaKOyhjsO73TOmU=; b=ZCdqOlY9qFH3kXU0/8nv3UuaE7UoI9u7SDeb/DhkWOxG/8ESQSj50tm6vqdoPKm2CS6rv6 8ntEZt66ASIzi+wK1spyQkv5oE4C0oRD6AoO2+aJ6nUJeHjEkJfP2ekpbGh01pKMMNiYuk b6cxFcw9jYTiv3Y8ESfVV8Jw1v5N4Oc= ARC-Authentication-Results: i=1; imf18.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=ohoS0Q5N; spf=pass (imf18.hostedemail.com: domain of sj@kernel.org designates 139.178.84.217 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=1694053781; a=rsa-sha256; cv=none; b=dVSeUHMxgx5b1O+PilsxHMZoUTqX1gtUGFCK9B9LvFNqouSosSSS4b2892pS02bc30WVP+ 78kxb75tviFDvHFLMFpDiM2ghSK2JVETU7fuwXvHDFih0pyqSr9aVueLMdblixtQml31t4 8+HGL/CnQH/IWWZTuBM2lNGrHKrMXIM= 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 AB02B611FE; Thu, 7 Sep 2023 02:29:40 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 0184BC433C7; Thu, 7 Sep 2023 02:29:39 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1694053780; bh=EttCSXcWQaBCLpMduSaDVf+bO6xFKw8ChvQvuGULuQo=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=ohoS0Q5NTqWvbTzBXP57Dq2ofbn2QBljXe1cpT6j4lRuQzRB3V3WC0/jjWNW9zKsh Pj0L+aNe9DpvOK+7f35EDNXepLHd2afINFwGotsGZrvFObI/8v0cnnEYpBOI2JUYmH /zr4DyQSRbrTK5dB2xtxZlxJVBO3UwjdbgcXEKRHJ7oe+HD6kjIPk8WJR4qzpiLMez orXkcK9BjJfpw0WtGMGlpGtkR3tkbB/jErb9/Dcmbg7Npz4s11Z0ecchpXsRgN5L5M t0gpXfrIaxSegMGSQeogKMEwEIC3I5l9+WKq0T+o70jZ9Bez1OALFBaPB6txHNOCkN ks7bnKiPNy1Vg== 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 04/11] Docs/mm/damon/design: explicitly introduce ``nr_accesses`` Date: Thu, 7 Sep 2023 02:29:22 +0000 Message-Id: <20230907022929.91361-5-sj@kernel.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20230907022929.91361-1-sj@kernel.org> References: <20230907022929.91361-1-sj@kernel.org> MIME-Version: 1.0 X-Rspamd-Queue-Id: 76EC41C000D X-Rspam-User: X-Stat-Signature: uw9k5hsfna9b8ynm1bg7p86ipzib6kw7 X-Rspamd-Server: rspam01 X-HE-Tag: 1694053781-558204 X-HE-Meta: U2FsdGVkX1+KBysRTR6RX6VkPgFufMCobFLP9Uf2YtZpqcfhZ9Qs1BX1uooBpl4woOVS7V+DdLH+eb2Dir+qIFBa/3AYoUR0NNM5RpJ+jV7HAgFY2pXfWZQ7KL5LpWd2rVHEq6EjT9YULyBzbTyi8njbNC3JWYr2lZcPbenfN19XfaDWnHCswTHdB2iH+ugve90j1db3codYasU247MzAFH1dVfzhzpt5gHuv8PqCPpMfol8j/7uxto1aSlVDlFp6BcljaASSybTjk6Pw+sOXsGVoK8J7Ve7KSboDuzbveiK8D0DMwUOxkFRgE+7MUemutbJI0fz3HWs9W0LWQ3e+WQn17ZZqZdp+tTrNcFPO8T5f0XJRltKWWiSt3UiVglgAmkbwT+MdIZQOeTI0qpP/YbYyd0bBBkK/Fd2FDc8Zit/MYdCqXCnUzJOeB9noe684jjZxckjH2G4PVWZpK6XWka7dsoQEXUfq3DILQaZmpVzmFZrJm08N9oS89p77KVz04j3DiH5xcuL7A3GA4SuuDQmijIbFc7Ny+8Lvo0n8xIn0p4qOObNDpaBjorh2ZUs3JuqxoFXnphXC3x+jXb3+W8JkfQty8Ips/FpF7EtgAX9ME7UzwCea2pYodUUUza31boVYHMM9ppxlVx3p1m3YTPaT8TOjd65MxYVNEWQtlUarV5IOTC21CXVjDdFJs2lC9NZRoGTNEWTv5E/B0Vko3G3bqwQVIIy/hXEBXd2Wlfh5DD4PjojEQXZ8zoGRTm44MUbB0FmQAiyUIFSJFCYK5elSnCG+E8SBJQwp1S9S88EZtwlO8ONs0Ner0rXO0mEwFSjciyErq0LU3UkD6xW+ixFB0GKzaAgc6MWbvmamSqmhDlNxW9Pj+5uGfvB88b+NNo/GGTYfnkhjKtz7M8RYx3I4bDf69ys4BUnVvwVyfjJWVHXyKy9qgsDOmhdX+VfLREehrYstBGXAMdIWWn PPYKna1X 0BdGd3Xa6AXS7MczThrFBJBbwX5Jbeh8uEY6N/9/VuEF4Jnf1D0cUHU/DKyuvUEGfuRr9cYuF19Ma+i5YHe+gM/YH6UAEV1inHKns0CaKBoFnE/ZJQhdp0QcYxO3ZAR9jHx/RhZcbMOQ4wvEY8zq46YSPvqHpeMvR2XVHZyJbNtVF82TZCoK/RORhHbVfXKphKnMOwXOAbnaNleTkz+uQNbLS0ynhzYJKMjA9IayWcFZVf7GIjAlU2xZXXfgWPIFCCmbzh1C8a9ivlRUUW/qwLBHiAGWl2iKGPUO+2qvv8aNUz4nCSIzDmh2vlxhUBU8g5VR00VonH0AYet40/WSHNgv48AfEGgI3cW1YByCsfc700ovJefXSBOXkc1wONjRAQyUd 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: The design document is explaining about the access tracking mechanism and the access rate counter (nr_accesses), but not directly mentions the name. Add a sentence for making it clear. Signed-off-by: SeongJae Park --- Documentation/mm/damon/design.rst | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/Documentation/mm/damon/design.rst b/Documentation/mm/damon/design.rst index a20383d01a95..5c465835a44f 100644 --- a/Documentation/mm/damon/design.rst +++ b/Documentation/mm/damon/design.rst @@ -163,9 +163,10 @@ assumption (pages in a region have the same access frequencies) is kept, only one page in the region is required to be checked. Thus, for each ``sampling interval``, DAMON randomly picks one page in each region, waits for one ``sampling interval``, checks whether the page is accessed meanwhile, and -increases the access frequency of the region if so. Therefore, the monitoring -overhead is controllable by setting the number of regions. DAMON allows users -to set the minimum and the maximum number of regions for the trade-off. +increases the access frequency counter of the region if so. The counter is +called ``nr_regions`` of the region. Therefore, the monitoring overhead is +controllable by setting the number of regions. DAMON allows users to set the +minimum and the maximum number of regions for the trade-off. This scheme, however, cannot preserve the quality of the output if the assumption is not guaranteed.