From patchwork Tue Jan 10 19:03:55 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 41599 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a5d:4e01:0:0:0:0:0 with SMTP id p1csp2920234wrt; Tue, 10 Jan 2023 11:06:04 -0800 (PST) X-Google-Smtp-Source: AMrXdXsMUD82PIz5V+oeE7GBnqwkJ2ic2g4bHkOtCF/wwsQmKVUWkv4jVpjdf6BPrtlq1+dNaIhx X-Received: by 2002:aa7:d752:0:b0:499:bcfc:f47b with SMTP id a18-20020aa7d752000000b00499bcfcf47bmr6096190eds.16.1673377564247; Tue, 10 Jan 2023 11:06:04 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1673377564; cv=none; d=google.com; s=arc-20160816; b=tP75h8ZfFyiu1u2IbvRaBRggiOCQb8PimBn1G8DSH3VP3l2wDCI8ajNl79rSgnt1fa oloCJP5L07bUtknEDXaTiXdq4z9gU6kSUMz8DNmuVcsC1WOsT4aq4s5f1YlNwT/CodBr 9OtPvllZk3Q9X4PpE4FnwHK7EmYoJ/jn9X6+uION8QSFw8tp//CPkxGvevGz4yFOgU2P AuPzxeNfD/oBElyAYAwR7uVIcLplNgvvBaITvcRoq+2EhOG9QpFg68o3l9UOKC2nkex8 TAK00E5xEB3qnbqlghWRjOXUB3uWYKmPtpL/8HjtTgrCjaPqdoiGQlI90DZO31GT3aql 6JFA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=qXdlWze7CnbACRYQWKOixA/MEHOlYbiYaK/zXW25OQc=; b=fy9OPp6MKlmBiXaCFpWb06BrT7bRKTDB8LNIdhNbpuoSUlIXimUAMBq9auHeFqBq4F CDgFZNM6VmAeqNLd89LR6IVZljfxeczXFFKSgO1kbT3c6YuqIR7+xGiCJrbezmjGmzYv k01TnNEIYdoEDDEKvoVEEYRDG8Xv8G9hgGk9qNWNFkuHj2yQqO6ITRMvZCbHTu9ZTDvv ILfd+UpX1hkpGAIQugsGsONT3AeCk7ynGU4WBH7BqRl5dZBRegwPJSD4rOgmSZHgACD5 3cmAUjmv9WI5buPvvfOBLSxDPi2ghO80uZPLVhPwRqSgajJ/AsxxgOQHxuiIjuhCmibL XasA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=Gr+KJKuO; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id f20-20020a0564021e9400b00484a42c8233si2592592edf.444.2023.01.10.11.05.40; Tue, 10 Jan 2023 11:06:04 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=Gr+KJKuO; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S239778AbjAJTE7 (ORCPT + 99 others); Tue, 10 Jan 2023 14:04:59 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:47088 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S239479AbjAJTEK (ORCPT ); Tue, 10 Jan 2023 14:04:10 -0500 Received: from ams.source.kernel.org (ams.source.kernel.org [IPv6:2604:1380:4601:e00::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 0537F640C; Tue, 10 Jan 2023 11:04:09 -0800 (PST) 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 ams.source.kernel.org (Postfix) with ESMTPS id B3337B81977; Tue, 10 Jan 2023 19:04:07 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id D3871C43398; Tue, 10 Jan 2023 19:04:05 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1673377446; bh=3/9jPsJGQOYl5LrCGMIIfDURssYf3Mb7HlJVYLs/nag=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=Gr+KJKuOm+aZo2aKeZ1tF+IL9mDXelWveS7Wxk+bEcvzreVPihAtB2EuuMgEG4Op+ bKsUP+zpKY5H5OKwlQ1yc0rztEYYZ8x1s0mC6r3gGnt5v4EHwJ3ZdU+seblcwUS9kJ JJRcXQkUBKSyGrsgIdCruJ94Gwan6MSt8zzoeUt8vJ7g0Q99TpzhfCz8DIwDVlC9eE gJ20GaqpN48kAhaG7aSW2eLbXd5U+5RPPD8klZYlhXRiw8ckt8WskQbS1YOuRi48x5 oRbPJPB+t0mhZ/CMMxTEZVxHRugcJwXgT99Ih/Y3waWx7CCb1xMDDlrpLe5Egv3gyc nOaZIpD2tfnvw== 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 3/8] Docs/mm/damon/index: mention DAMOS on the intro Date: Tue, 10 Jan 2023 19:03:55 +0000 Message-Id: <20230110190400.119388-4-sj@kernel.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20230110190400.119388-1-sj@kernel.org> References: <20230110190400.119388-1-sj@kernel.org> MIME-Version: 1.0 X-Spam-Status: No, score=-7.1 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_HI, SPF_HELO_NONE,SPF_PASS autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1754663552885784908?= X-GMAIL-MSGID: =?utf-8?q?1754663552885784908?= What DAMON aims to do is not only access monitoring but efficient and effective access-aware system operations. And DAMon-based Operation Schemes (DAMOS) is the important feature of DAMON for the goal. Make the intro of DAMON documentation to emphasize the goal and mention DAMOS. Signed-off-by: SeongJae Park --- Documentation/mm/damon/index.rst | 21 +++++++++++++-------- 1 file changed, 13 insertions(+), 8 deletions(-) diff --git a/Documentation/mm/damon/index.rst b/Documentation/mm/damon/index.rst index 48c0bbff98b2..2983699c12ea 100644 --- a/Documentation/mm/damon/index.rst +++ b/Documentation/mm/damon/index.rst @@ -4,8 +4,9 @@ DAMON: Data Access MONitor ========================== -DAMON is a data access monitoring framework subsystem for the Linux kernel. -The core mechanisms of DAMON (refer to :doc:`design` for the detail) make it +DAMON is a Linux kernel subsystem that provides a framework for data access +monitoring and the monitoring results based system operations. The core +monitoring mechanisms of DAMON (refer to :doc:`design` for the detail) make it - *accurate* (the monitoring output is useful enough for DRAM level memory management; It might not appropriate for CPU Cache levels, though), @@ -14,12 +15,16 @@ The core mechanisms of DAMON (refer to :doc:`design` for the detail) make it - *scalable* (the upper-bound of the overhead is in constant range regardless of the size of target workloads). -Using this framework, therefore, the kernel's memory management mechanisms can -make advanced decisions. Experimental memory management optimization works -that incurring high data accesses monitoring overhead could implemented again. -In user space, meanwhile, users who have some special workloads can write -personalized applications for better understanding and optimizations of their -workloads and systems. +Using this framework, therefore, the kernel can operate system in an +access-aware fashion. Because the features are also exposed to the user space, +users who have special information about their workloads can write personalized +applications for better understanding and optimizations of their workloads and +systems. + +For easier development of such systems, DAMON provides a feature called DAMOS +(DAMon-based Operation Schemes) in addition to the monitoring. Using the +feature, DAMON users in both kernel and user spaces can do access-aware system +operations with no code but simple configurations. .. toctree:: :maxdepth: 2