From patchwork Thu Sep 7 02:29:24 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 13376100 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 76E87EE14C3 for ; Thu, 7 Sep 2023 02:29:52 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 285A028002B; Wed, 6 Sep 2023 22:29:45 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 23687280029; Wed, 6 Sep 2023 22:29:45 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 0AF5128002B; Wed, 6 Sep 2023 22:29:45 -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 E9F80280029 for ; Wed, 6 Sep 2023 22:29:44 -0400 (EDT) Received: from smtpin17.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay06.hostedemail.com (Postfix) with ESMTP id CD50FB42EC for ; Thu, 7 Sep 2023 02:29:44 +0000 (UTC) X-FDA: 81208220688.17.AD44CA8 Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by imf15.hostedemail.com (Postfix) with ESMTP id 453A4A0003 for ; Thu, 7 Sep 2023 02:29:43 +0000 (UTC) Authentication-Results: imf15.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=I9w1kxv9; spf=pass (imf15.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=1694053783; 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=KMJyRsRl0+WyLbI9IfWC7CH5HJg0EsWACMvwQ7Z8xg0=; b=zhFDaG/HA80cF1bUVhKtcXjgnuW7wbGuzZTkQXqwVrH3vcy0VQUZJvnW/Fk7A4BzFZU3gy XLhW3p3J7WnZdY+HptnvaoOgb4gcru8Im1orRpkTbLsHm6jLZQyuCscTEONyHY5bg0vyGU 1vBVLiVMUUp1pnUtCksdz9W43izdV6E= ARC-Authentication-Results: i=1; imf15.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=I9w1kxv9; spf=pass (imf15.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=1694053783; a=rsa-sha256; cv=none; b=MNmkUjpWBZY/5Wgd1QAVDB/tjClNQSea1RJjvhgVO1wkKT7C5/VCojnE8ETY/PsG2/Ou7W ANEVv/VSEi52HOs5qrO1UWDQ0BESm2QcVGbC7TjHM9bsfegISVqk5UYo8rQxkT6PpYRr7X 2sQbqiO7zM6UgGfhIdZbms7SrJ8i2PQ= 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 7D94161211; Thu, 7 Sep 2023 02:29:42 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 73D10C433CC; Thu, 7 Sep 2023 02:29:41 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1694053782; bh=nX+lBCNxvHlh2Hd6gi4Ol2YBYOd7nIVtVx3JTRH4uq0=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=I9w1kxv9RA186Id0zHiS1zj+BAWURWAM5lFzFwxGnAFkbOzT+alc0bJOmHHWt8jct Q4jtNAkHhp+5IA6yHicRT3lr/mvEFKowHjn869YNnj4WhXTR6m9pryGxMT2+ME1DTC DMptSU91rd7c6N4zVxIIoXhw+QDzsyi0AO1xQdEgloEG1ovEnYjbJyUsoo6s74QWSp beuyoPPwVNVq+pc8howL9hkKWIUO3KAdpEzIpzs3Hhu0WBQMaGsAOnUtSDLvDS21uK qwRvMdnKNG7PeimG83FzH02OCX+LD3nmd+vZ0CUO8eRiFMPYGbJ+Ekra1waYsgazYV Kr6xv4L++j1iw== 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 06/11] Docs/mm/damon/design: add a section for kdamond and DAMON context Date: Thu, 7 Sep 2023 02:29:24 +0000 Message-Id: <20230907022929.91361-7-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: 453A4A0003 X-Rspam-User: X-Stat-Signature: xfene6yb88qfmyx1af7gxcfc6971bemm X-Rspamd-Server: rspam01 X-HE-Tag: 1694053783-793637 X-HE-Meta: U2FsdGVkX19lkMESrf+QrEGnRq87jsu2pdlv0ux3IMEkY8GxNPB6K+exJNNS47pTT5yB/4VKMuDwYV/8OMNMqilyePkls3Y2xx2DQBcnlVQtN88LbzOWeV6aEXhjKLpNzyyD2+XXKMhGB7k3a+X2IGj00dCEpPbqyVvTIvdkOW411s7OG1qYBUfqEwsYNrGSszvIEWMC4smkcA5zuzJSMd6VrnK/0gxrfG8+e7ZB8qQvQ72j1lOh9PJh0PNH/yUtPyLwLocNRoHF983C7qBQgkfAD7LRuU9EO5Hkc7OgTkHKQ68+KdfD6zDrp6yPmA1j5pgOQ3NtOW2xhKwdqIkTVw+yc8GzvJOK5GAX2LXFvP1BTRWsrP8Dp8q79mmqKHCWMUavbllGDvyuQOgSF4ae19Acp+ltGQGoqIRHIq2gX+nuRU+gKyar1FF0CxkbZeBUwSOO1f8PRE0vnKEUDzdXYggp5T6bAW7G67XOGDJMQway3SkyTadotEBW5zaU7JTqjrLkNNvM11lUz8wTRzWj+5CL3l4Qs15LkNHjT5XnKCCxg8IM5HwyFF7M0CSLcWvyTEsTTEKAJ2tIC7ndKpXmAn8o/DowxnSEXNDdyD2HutI6q8E1RY1gu6P6u9JlhUaF8LCG4RpNp0LlDOxHxDd16XAtWKdx9iOJkYrvafvi0hQOI8ZzHlugWf15f2XvfaceSqRqPRc48jirvtRxQLFhKffNQJ0uSgO7C5+B7XJJ08DEhMxrFSVOnDgKHOp01lraKR9fSKP4Qlwz1hZ6GhTwY2aBB7lgMCvfmF+V80iCYJKy86MD0gKdNX60FTdoGkW95w2H5tTct7VAwgOEaoQyMs4x3G1i7raDb3l2Hr3zbUGh2ZjXrYwUwSdN0/2sN1DNMYrVbt40WgxhBvZXdaImT2kwSBOJI/lBLRbnAT5Gc5AVLepYqRC9f6Vw0IR0q5Ef2f6opiO2WTsKIAEcVos N+bDy7hf 4sTfssW6i99GDgGttGMvx1bPRQrxwRxXoBLxBx4sxmGZj2AnT/SkIgnJ7bpIBAoaazZecRX7peMkZ7RPLUWkLrSUx1k5u8qWUONMmbYp0Y5MKlAccyIPvBIfaGUE9WiP8W+scSJIdvkgHQjGybs2t59aMELWLQeSD/WjKVhaCcNtsPe/Yv9j3xd1ky7vK1BF7Df514g6PIwaVyft6K+uf1p4gI9nKhenld/YAH2A+NLjRomK1uHIZgYhmVYpRvEM7tsYTdcizZLZyTfdR/URjeGh3vCFaaGHozQWGTsX3I7gQE2YZx8RbKDyybLcQmNrxQgKYqlaYEdRfZ7uD4wC+7g7AUg== 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 not explaining about the concept of kdamond and the DAMON context, while usage document does. Those concept explanation should be in the design document, and usage document should link those. Add a section for those. Signed-off-by: SeongJae Park --- Documentation/mm/damon/design.rst | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/Documentation/mm/damon/design.rst b/Documentation/mm/damon/design.rst index 51aab9b0621a..ee099d45fea8 100644 --- a/Documentation/mm/damon/design.rst +++ b/Documentation/mm/damon/design.rst @@ -476,3 +476,13 @@ modules for proactive reclamation and LRU lists manipulation are provided. For more detail, please read the usage documents for those (:doc:`/admin-guide/mm/damon/reclaim` and :doc:`/admin-guide/mm/damon/lru_sort`). + + +Execution Model and Data Structures +=================================== + +The monitoring-related information including the monitoring request +specification and DAMON-based operation schemes are stored in a data structure +called DAMON ``context``. DAMON executes each context with a kernel thread +called ``kdamond``. Multiple kdamonds could run in parallel, for different +types of monitoring.