From mboxrd@z Thu Jan 1 00:00:00 1970 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 AF125C7EE2F for ; Thu, 25 May 2023 21:43:33 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 40867900004; Thu, 25 May 2023 17:43:28 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 3B6D9900002; Thu, 25 May 2023 17:43:28 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 209CD900004; Thu, 25 May 2023 17:43:28 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0011.hostedemail.com [216.40.44.11]) by kanga.kvack.org (Postfix) with ESMTP id 0D09A900002 for ; Thu, 25 May 2023 17:43:28 -0400 (EDT) Received: from smtpin15.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay09.hostedemail.com (Postfix) with ESMTP id DFF6B80AE6 for ; Thu, 25 May 2023 21:43:27 +0000 (UTC) X-FDA: 80830104054.15.4847926 Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by imf29.hostedemail.com (Postfix) with ESMTP id 8BFD5120014 for ; Thu, 25 May 2023 21:43:25 +0000 (UTC) Authentication-Results: imf29.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=ZRtNgrzl; spf=pass (imf29.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=1685051006; a=rsa-sha256; cv=none; b=xqB70JIO7/xxjQLv9XRbtrx1WBl6pZZ+NXVI+4FsRxBGwpo1Qmtim9+2EIeSlFTRwEjSuy FZiWnvPZ2UThxEGJ3rYMqWxLTMqXhhCT6zNzJq16cH/b9Y3UOX7/VeiXad7FWgtYgEz3dR tmK3/I8lIatTVz8oeC+QIUoQ8PZC190= ARC-Authentication-Results: i=1; imf29.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=ZRtNgrzl; spf=pass (imf29.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=1685051006; 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=kVj9MGetKxz20CAAyMJ+u5vcrf5oTJJGhw5moEiDoaY=; b=7FuPtwUpw4dT2yGav3z8CldJFa5ukSSMuWN/aOE4Gt2V308QkcjFnYuxl+tbiQ+He2myyV TBY+GRHicnSFPDD1/jda8Xt+nsR9WntMg6tJQ5WxvZx5sr1H9+LURPHKMJSEb0rqZp6sZW cn9H+nUfG/KnzACArVll3CUs8bccJso= Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by dfw.source.kernel.org (Postfix) with ESMTPS id 4863B64B66; Thu, 25 May 2023 21:43:25 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 36A86C433AA; Thu, 25 May 2023 21:43:24 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1685051004; bh=kRx7Ql+X4ob3mmhrjF9h89mhxljZdGi0sjiE1FJX5Zc=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=ZRtNgrzlQpPWHCCJkCxIGW1T5QYX30ZV8PyfpuCpNijZF9fG2o9gwhI6hI1HuJuXB hEwvfN7QVmwNyqjHfLLBfdaSIwkwvAeh4ai3YycdDhNdLrn/guKnvJYpJxeSa1o32c m2WjEJiDsMxQNDzClBhV3o2/T/UchbSiFGGtIQ+d0lsE1tOsOIlXxCuEgOEhMSMPla JQJBV6ZYCoZXflk0PqwtzFGyYe6sLxQAQ7MU1tQjmuPzm2vL+AiCHkc4D7ehrXqizE HD1eVdUSAJxbUwSnSU5CRNkR6EqAb+1My+CxxAybPlhXoNzE+GHkvt7oYzk5/Nb5Bk kz20ij5EG1pUQ== 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 05/10] Docs/mm/damon/design: rewrite configurable layers Date: Thu, 25 May 2023 21:43:09 +0000 Message-Id: <20230525214314.5204-6-sj@kernel.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20230525214314.5204-1-sj@kernel.org> References: <20230525214314.5204-1-sj@kernel.org> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Rspamd-Server: rspam08 X-Rspamd-Queue-Id: 8BFD5120014 X-Stat-Signature: bp1emkwrrfujrccfeesy9tat6ruf58xz X-Rspam-User: X-HE-Tag: 1685051005-636847 X-HE-Meta: U2FsdGVkX1/U1Z4Li+g3jbDS2Erjlwu+n9hlOu1REVygdnv0j3eO++bbzrkkFaTVv63cOoHmR3kNDwyGWJDfRlcXel1qq2Wo/uTcZ3/jZfm9F7uo6uSt87jEQ918DUuh7bMBKampSwq84iKIvF8QFjKCAoJz0ZpDm2pDLT4mGTdD69DzzryxQaATL5gVtOz6VYoeoCIxEH6XeI1sBUh89O/PgU6QNMYXM50m8X6mVWjuUPIb0WVUVJPjXgPRrAjI6wF/ebIo8FccWBJFna2gwliUJNkzsl/Bo0cCHeioV2U+2PS/C59NXd3FpBWDuwCn09FiLQTQHo8AlbYQ1LWSHNj48tqD63vhcdu5Fz6lixR9TlpDwKnJzeZBpG/jgUXtJRXUFCp2EuP4MunOClllT4oINMlgxVDQnp+O96JwIMy0t0lyqi7qR3bylpGrWpDUxuVRFT3mC031TT7Sha+u9JbwcPC7+JGKu3leMIH43f1RXZvR1BZCllzv/sQScbKg/xt9ssg+r1DBR0L0JYi1mJRiNNwpspkiwdXxgrjOsck81MAJDDHczWAaxar9WL6it76gwGL9PZecfBUM/tsloAPo3xrawQu8qkP5+uiOY786X7wLdMPNwkmgoF0C4CVItW1ZQeuTEhl/f1Vkd0TGkpxQPKjrfwe3SUdYIpCsAtm/LM9gWmcgnKy0/z3y8kR0N8xfBxCSK8wekRsO3AW4ukeJiiLtlU1k764co5eESTSo4NyY7avYTw93DscCrpQChl1gNd3s8f1/havGE2hPsKy9JPZklZ6SN/0s/0tXHUx/eOBT9KPmALjE8wY6kNZVNolVcp1y572GSXEcvLHbT53/a7XLN3mRwF0EQqWj4IIo2Q+4eTHDW6XD+I4ftwfFv4r96Rc5znt2Ef+14fsdvsQKb9Gl1CWtIz0ULzOrtMHyaw/X+2rMv3zOAVVnrTCp5KIQin2ipRmTbzX/5t/ +JEPlX+5 8DHi4RB7Ym7NPpNLPsYvRuELK8ukIgkMji3YTPsp8wS7pujhXPQADnfJ4FH4GGMpMes7Xp+zKuGhnukH4S11WLMiJclYuvxWjkWTNbBab1kZYx4EKdDCsauQ+oP3lxXZjOn3OfSFLfr61yLvIa5Lhsi4zYcNou4/0jUNakhKPIx6yawnIcbNjtpwaJUKBRA88mmORvEiqSYJLxN57+OLWtXnLdrEXTQsjt+GAAXcuh63VShyYE+qkMEhBA+tIBIl5H2/mjmAWE5S64cHR8bVhL3EoTttuXJ7W5HNxArS2RzvrDbCnHp8cv9RdeRSS7+bpb51WQ1+qUoDKo8iaPElDrTFYIA== 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 'Configurable Operations Set' section is a little bit outdated. Update the text. Signed-off-by: SeongJae Park --- Documentation/mm/damon/design.rst | 29 ++++++++++++++--------------- 1 file changed, 14 insertions(+), 15 deletions(-) diff --git a/Documentation/mm/damon/design.rst b/Documentation/mm/damon/design.rst index eaf52f3a9144..4a22bab124cf 100644 --- a/Documentation/mm/damon/design.rst +++ b/Documentation/mm/damon/design.rst @@ -22,24 +22,23 @@ DAMON subsystem is configured with three layers including Configurable Operations Set --------------------------- -DAMON provides data access monitoring functionality while making the accuracy -and the overhead controllable. The fundamental access monitorings require -primitives that dependent on and optimized for the target address space. On -the other hand, the accuracy and overhead tradeoff mechanism, which is the core -of DAMON, is in the pure logic space. DAMON separates the two parts in -different layers and defines its interface to allow various low level -primitives implementations configurable with the core logic. We call the low -level primitives implementations monitoring operations. - -Due to this separated design and the configurable interface, users can extend -DAMON for any address space by configuring the core logics with appropriate -monitoring operations. If appropriate one is not provided, users can implement -the operations on their own. +For data access monitoring and additional low level work, DAMON needs a set of +implementations for specific operations that are dependent on and optimized for +the given target address space. On the other hand, the accuracy and overhead +tradeoff mechanism, which is the core logic of DAMON, is in the pure logic +space. DAMON separates the two parts in different layers, namely DAMON +Operations Set and DAMON Core Logics Layers, respectively. It further defines +the interface between the layers to allow various operations sets to be +configured with the core logic. + +Due to this design, users can extend DAMON for any address space by configuring +the core logic to use the appropriate operations set. If any appropriate set +is unavailable, users can implement one on their own. For example, physical memory, virtual memory, swap space, those for specific processes, NUMA nodes, files, and backing memory devices would be supportable. -Also, if some architectures or devices support special optimized access check -primitives, those will be easily configurable. +Also, if some architectures or devices supporting special optimized access +check primitives, those will be easily configurable. Operations Set Layer -- 2.25.1