From patchwork Mon Jul 1 19:27:06 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 13718589 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 6552FC3065B for ; Mon, 1 Jul 2024 19:27:32 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id D082B6B00B5; Mon, 1 Jul 2024 15:27:20 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id C8A2A6B00B6; Mon, 1 Jul 2024 15:27:20 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id ADD8B6B00B7; Mon, 1 Jul 2024 15:27:20 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0010.hostedemail.com [216.40.44.10]) by kanga.kvack.org (Postfix) with ESMTP id 861686B00B5 for ; Mon, 1 Jul 2024 15:27:20 -0400 (EDT) Received: from smtpin09.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay01.hostedemail.com (Postfix) with ESMTP id 53CB51C197A for ; Mon, 1 Jul 2024 19:27:20 +0000 (UTC) X-FDA: 82292167440.09.69D089B Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by imf28.hostedemail.com (Postfix) with ESMTP id B5066C0016 for ; Mon, 1 Jul 2024 19:27:18 +0000 (UTC) Authentication-Results: imf28.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=X4uyulKb; spf=pass (imf28.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=1719862028; 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=6ce8MEuI8ZioQPeNPX4DDZDStYJWCPUnczWPRbIwdFk=; b=1/Lim3GmMNOK7LBD4UQ8QD5+6WKSeTZWwigxc/sTCSrqXeuLVVOduLAJQMl0njAzZtdwwM LWZNK0BiL5lqpmMtfaBS9SUDTLFAgmT3p6k08NT9v5IQ38PYQtjGs2wJ7eJRhU11AaynSX h5pYnRk4es7OX3EXF+4m0YoIh8wY9NI= ARC-Authentication-Results: i=1; imf28.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=X4uyulKb; spf=pass (imf28.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=1719862028; a=rsa-sha256; cv=none; b=7N9be8B5Nop7rYqzyahA4m6QegpvUKh2wtlzO4vGQ6wthKLlcKYr9auFo+K2mgNVSMtpdN 9SanOzf8mfahhR71xHejNY4D9aMSKUlFQXA5kS9Aym8f4iXNyLcgOvvL9+1P+45LjRBTJn Y+oBbTwAyHGRHtpY/OzXNaU7paNwUbA= Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by dfw.source.kernel.org (Postfix) with ESMTP id F04CE6178E; Mon, 1 Jul 2024 19:27:17 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 4BA6FC32786; Mon, 1 Jul 2024 19:27:17 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1719862037; bh=fBlkxk1Ff29Zv5hf2sNJnmiHJF0MltvzTSJLNhDvsG8=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=X4uyulKbdcl37BYLf/rxxpfmLRRiHxgo0DdJC/AznGxFaPaD2j5tC1707zu7MB4m+ oJHVeSBr7Hsz/iQ3j/bCS+ZvrNDhcRNnbYDp38oh1BejNsY6D2hqBEd7NFK9vT7oPL F9tXsQ2/A3l7gcSZ0M8xHvwtA/eaBmHnRDfcG8tEVoGMwvD/AvmZpVT3QDVEMiZ+1r NTLTFMinIq0OI2PmAO8xdUtoayV+W+xeFoncTB63jXwm2TR/4ALWSu+g6IBJW38x1P 4iPYzXgQ/QfldH4VQCg/4E/SXPmzn6KWDXXGiOWQGfl6aYfF94MwLNs97Pu3CFNO6b AFaxzonaM27Cg== 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 9/9] Docs/mm/damon/index: add links to admin-guide doc Date: Mon, 1 Jul 2024 12:27:06 -0700 Message-Id: <20240701192706.51415-10-sj@kernel.org> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20240701192706.51415-1-sj@kernel.org> References: <20240701192706.51415-1-sj@kernel.org> MIME-Version: 1.0 X-Rspam-User: X-Rspamd-Server: rspam01 X-Rspamd-Queue-Id: B5066C0016 X-Stat-Signature: 3e5uu9ecty6g6exrwsiyfk48chb3tgud X-HE-Tag: 1719862038-123489 X-HE-Meta: U2FsdGVkX1+R2ncvBRUanh8j78M1Uon8KsfVrzHwHBAMgGk5wPEBN6E1/QNl4nR9VXiivbHx1yfbveXujiWKyfFgB8DByoX7Lgtw0q44nHal8g0ckutKN4bUVoDjnTFzxbFZqxYVwZ6fkfpAIRgvO/dOFlDFbLglrY8zn9qVk1Y1uE1UcYBkVw4IlkdN+bA4Mo7JwdJHyGammEuPD3EWIuEgPqmHVMBpRvX1j7wnr+j5s+3gz4mrN3b1CtELr1PDBbB3FqY6t6NJMTxlUGPiDP1LBAS0BRZ/9ETY0TnUHvByjqgEr8FgdODP3jhytKzyO4aknZB4MVyD61JGbz1UnbkVSYd+99yggtLhAo9rfZaIp0IayIkDxgHyC9EcD7kgLctIQCLDOLt0j84uf7WjQB74pp2HK2pUnnn3NaFcwYjPCkN7GANtzcBuovokrWfe1bGDZNIlB9SpNApTuqWWsDLC3gBeBKE+g/1r0quLO/P1It7/Waq2DU+YfYoqqV/AVK1PS2BmyC/NL6pki8FvE5b8dvb1VdT6jJFwxhUqdjFkNY416yW2UWoxSBFi/QvroOWkAog+afMAw1fiWFbPJHXz4Z/5beL5mPAdoeg/Rh6Qc5mXE06t+IApteIWnauJFBEMTUKw03toph1LxH5WuAfVYIgTURUX330ecnVzUQhO50DvM8D/Dgag9osFpsSgMohCZToMAmbaVA3EZJSAXBmbLZo5yK5NmlbYLvNyJJcgfnnhgRTvIGLvrRZYvg0VGTqpSzFBehlDbsmH29dWI/1KWQ93SQgU9AABQTJ9Sn7cDKgBwZiXigYuzLZCtBX25moPwPO1tcIdNineasnzuEXzu7N+4p+Kajn7EoPucMFyYWQng4yS2Wx/9zccDwlas1weUoGbh1dEYYiy/YRSLl1FGH3wVbdtlOCVGAJF2mGNyAXcIcxrK69JWXXbYZ0Vh0PExpZONWXLgO5vpKz cm+GWUjZ LHofXJl6N9T8McZDh3t2n1sTFvPXR7BMuy+ge4TOBxyA/30OSgH2v7YzKCqJAzfv5/kZw52rXxA/k4pNUIq6wqqfgXTTRq4rk1vfVjTL1zwGdrjvUzDk7KPWDhp3Cv7psqdxDYToZISsabYjj5fh2b8cFnI79SjRhM6eb5CD5PXSLU6ttCvXyhTtzE50onVB6scHJ11dWDfQ1Pv8Lvi8xVPK1i54a9vUM3QHAGGCY94ryXc0Z8tJZ6mi+WlVSSWOzLPbLMzCXn9Z7S8Q= 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: Readers of DAMON subsystem documents index would want to further learn how they can use DAMON from the user-space. Add the link to the admin guide. Signed-off-by: SeongJae Park --- Documentation/mm/damon/index.rst | 17 ++++++++++------- 1 file changed, 10 insertions(+), 7 deletions(-) diff --git a/Documentation/mm/damon/index.rst b/Documentation/mm/damon/index.rst index 3d3b345d8889..dafd6d028924 100644 --- a/Documentation/mm/damon/index.rst +++ b/Documentation/mm/damon/index.rst @@ -16,16 +16,16 @@ monitoring :ref:`mechanisms ` of DAMON make it of the size of target workloads). 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. +access-aware fashion. Because the features are also exposed to the :doc:`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 :ref:`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. +to the monitoring. Using the feature, DAMON users in both kernel and :doc:`user +spaces ` can do access-aware system operations +with no code but simple configurations. .. toctree:: :maxdepth: 2 @@ -34,3 +34,6 @@ configurations. design api maintainer-profile + +To utilize and control DAMON from the user-space, please refer to the +administration :doc:`guide `.