From patchwork Mon Aug 26 01:57:39 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 13776956 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 63E13C5321E for ; Mon, 26 Aug 2024 01:57:50 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id ED2026B02D4; Sun, 25 Aug 2024 21:57:49 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id E823F6B02D6; Sun, 25 Aug 2024 21:57:49 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id D783B6B02D7; Sun, 25 Aug 2024 21:57:49 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0016.hostedemail.com [216.40.44.16]) by kanga.kvack.org (Postfix) with ESMTP id B7B1B6B02D4 for ; Sun, 25 Aug 2024 21:57:49 -0400 (EDT) Received: from smtpin04.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay06.hostedemail.com (Postfix) with ESMTP id 2C024A86FA for ; Mon, 26 Aug 2024 01:57:49 +0000 (UTC) X-FDA: 82492735458.04.2F445DB Received: from nyc.source.kernel.org (nyc.source.kernel.org [147.75.193.91]) by imf04.hostedemail.com (Postfix) with ESMTP id 85B9240006 for ; Mon, 26 Aug 2024 01:57:47 +0000 (UTC) Authentication-Results: imf04.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=OCq7jEWa; dmarc=pass (policy=quarantine) header.from=kernel.org; spf=pass (imf04.hostedemail.com: domain of sj@kernel.org designates 147.75.193.91 as permitted sender) smtp.mailfrom=sj@kernel.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1724637372; 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-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=vD522FqsVD8oFCmYHslVV4jl9hHp+8qApa/84b0OVfM=; b=n/vdHYFUEqY6VZ8OlCceqq9OeMXtwkba7Kr5ZvsHO5ubcVfng9hvNO8H9duKBlbZquQ+AI ZbSmnx+TUvE0//ChXHhDWCbftLmpa8C0/NOaKDibPBTYTVKWaELmhgESvoKHhl6I3xVfRj PfUX3to6kMc3nLamC57XXgZG/OFUoUs= ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1724637372; a=rsa-sha256; cv=none; b=nHG4csgEXkA0CVY4IJuKqknWeugLE6XnGcdO5L/Qp0t+quqKBE3Gk84EY7jlMZGjW8tI3O RZZlMGq7eQ2SvltV59tXYuGNBJ0uY73WKUfhmn5ACtlfYO8xnxnqw2PLWJk1at0aZtdJr3 zhD9uYXXQuoNK/v1vlvCtsRRXczGSqo= ARC-Authentication-Results: i=1; imf04.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=OCq7jEWa; dmarc=pass (policy=quarantine) header.from=kernel.org; spf=pass (imf04.hostedemail.com: domain of sj@kernel.org designates 147.75.193.91 as permitted sender) smtp.mailfrom=sj@kernel.org Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by nyc.source.kernel.org (Postfix) with ESMTP id D5562A40DDD; Mon, 26 Aug 2024 01:57:39 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 9C3B6C4DDE0; Mon, 26 Aug 2024 01:57:45 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1724637466; bh=pwhigTWrAj+bVozK+KGGpzFVunvCQGvZz9bEWXYLYdo=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=OCq7jEWaNCUAnL0Hi2mb5n2a3CBqOJKYLLq/2YULUe8usYzcUoIQec0yQwu89wPTn Y0Dm8ond2Y2Ufb5RwVe8BxHVrjIZ9gy+apYD2V+5Sry1dQUwSC8BcfyLo95m30b2Xz mJLG+P1Huw/+v6D2j9yudhqqMLEs0GAtPfo3ohgkgWdnFrP9YPhM0CjubC3uAxXfMH mPoscYnccTUcKyxEY/3SDo5HqdBthOTmIC7oxfh7j4ngvNpA7RCXc/ZxdVN6gLgo0A IAynApN0jkSrZ/KPfd9ImqB8qXzypMi1ivViaNd7uTh0l/X15U2jnuKvgKd6sQCB4D pl37du2NiQVZw== From: SeongJae Park To: Andrew Morton Cc: SeongJae Park , Jonathan Corbet , Alex Shi , Yanteng Si , Hu Haowen <2023002089@link.tyut.edu.cn>, damon@lists.linux.dev, linux-mm@kvack.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH 1/3] Docs/damon: use damonitor GitHub organization instead of awslabs Date: Sun, 25 Aug 2024 18:57:39 -0700 Message-Id: <20240826015741.80707-2-sj@kernel.org> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20240826015741.80707-1-sj@kernel.org> References: <20240826015741.80707-1-sj@kernel.org> MIME-Version: 1.0 X-Rspamd-Server: rspam07 X-Rspamd-Queue-Id: 85B9240006 X-Stat-Signature: 35pzs49rr5ssbkkucuzamrhu8njg6i34 X-Rspam-User: X-HE-Tag: 1724637467-666210 X-HE-Meta: U2FsdGVkX1/EBtRne1Gae849f6+QujiVkR03U5bOhfcdGaFkgh31UkKhXegBwRRMJH2ZRFNsLNZd7GIgc37DmB7oe/a9pMG71mPtboQjy141XlFXb5SKtTd7qWCT9ufUi62xXTmuU933IaZ+J1QIV9T0zS4NUvHfeVKKsd4orzLikS4mC+WZ3IiOPtKFfabsZ5YDJxIOwROnNqPWxp+hp+flcgJn7JWXJTqnY3a02DiblvLY9p6UmrUd81sYPbRrMXJO+lpT1RPNCTQgrTsyvxMHDgEXhC9Ut9AeDlVYiBnpKu9wh+xaYHmjgNlY0zxzZDaDfHmBHxZmnpoRk7bdkMhKiI3BFfpDj02WzifSr4LPCUcRUqomLRYiaHwS6e2xFyMinVWWorxUCDECInJbndSgJq6h0024iUCVrSdcyDD77KelbmLmw9+ErH6Jddg7OkVlXoCw7tkIp7qDkZcaugC4zXk1CNV9EwwhVLQPUJlo52Lk5SZLzuSp3NHAwlMCk6GnaVtoYF7JgVal6Q+Yf+y4sve8coDNcNWLVhWKHfdZTedivvh1Qvy8IhraCHAoNKMavilVo+TWbwgAYm5oRYsbSMyYUXwRLz7B3jm4GXq78fJvnQosOS8/EuN7Xg5CuzN81JtPqTzfFmVl2u2kp3g4j2V+UpryIcmT6sXt9WWjpKDyAj2GKp/DzI7VbtIut7KRNcbQzpDC91Hubl8OqzgK73XWzJvdRnA9/oX4Q3QT7P/rsAUbJL1QdvEz/i26j10DCnTpGYMHxys2wsOjTauK4kiOl+Xj1DDN6tkPnXsVJxq/Fl+I8q+KL+f0FTU7CHi4uBrEJ++W8W6WBCwBcrzT37niqXKGGf+DmIXdvVu1XQ8AxxITQbPPt6U5IsNC48plYGhXbl4NNR7QYTznOSZu0RNbNq+dCdf0A84LV1P8h/ijVMGcqBUOa0uzpTmtehuxLconGTJ9M/8rHHK 383JpE4V hMX76WCNPAuM2FyPNi6RqMH5+En/NroNenKa8brrVKYARtDaVrtziVrsNzFnKkFG+NKYE0FXjcs/lOD+qvSmHuAjm1wD2kxEdDMpu/LO7Okzhsf+tOZAEIKM1OaIED/VOj075TAwg4qBYny9B5y1Dx1xHls6i52Ze/Do/xIz7oMWrRYfaX8S3rdmGmrR2CuXkFBG+M09rRcVyWcCDLh4Ew3AXCEVHIDDp9DMYZUv1BBveC8Fdrjviy+9AqjAbNxykGKOZI4TIIJKsViumtNZW7tlauBETJ4hcgx7Pk8SSCzlNWWQS2MeqdqQx7ag2vQ3mOCAqruxsvGo5qmOzXQ4EoLz8OlNOQUTfi/LRSAnBzAn729HCZR+qEJyLF1g7xJG5oLfWFhwQhH1xTiYFO0DJf5Ukbx9E/IUclSUSK5VhdYsWIKC3jX1sP2Pqe1Y5VU0QBufw9zW8ueHiQDd+gAM0Cf3N7A== 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: GitHub repos for non-kernel parts of DAMON project including 'damo', 'damon-tests' and 'damoos' will be moved[1] from 'awslabs' org to 'damonitor', by 2024-09-05. Update related URLs in kernel tree. [1] https://lore.kernel.org/20240813232158.83903-1-sj@kernel.org Signed-off-by: SeongJae Park --- Documentation/admin-guide/mm/damon/start.rst | 4 ++-- Documentation/admin-guide/mm/damon/usage.rst | 8 ++++---- Documentation/mm/damon/design.rst | 2 +- Documentation/mm/damon/maintainer-profile.rst | 8 ++++---- .../translations/zh_CN/admin-guide/mm/damon/start.rst | 4 ++-- .../translations/zh_CN/admin-guide/mm/damon/usage.rst | 8 ++++---- .../translations/zh_TW/admin-guide/mm/damon/start.rst | 4 ++-- .../translations/zh_TW/admin-guide/mm/damon/usage.rst | 8 ++++---- 8 files changed, 23 insertions(+), 23 deletions(-) diff --git a/Documentation/admin-guide/mm/damon/start.rst b/Documentation/admin-guide/mm/damon/start.rst index 054010a7f3d8..c4dddf6733cd 100644 --- a/Documentation/admin-guide/mm/damon/start.rst +++ b/Documentation/admin-guide/mm/damon/start.rst @@ -7,7 +7,7 @@ Getting Started This document briefly describes how you can use DAMON by demonstrating its default user space tool. Please note that this document describes only a part of its features for brevity. Please refer to the usage `doc -`_ of the tool for more +`_ of the tool for more details. @@ -26,7 +26,7 @@ User Space Tool For the demonstration, we will use the default user space tool for DAMON, called DAMON Operator (DAMO). It is available at -https://github.com/awslabs/damo. The examples below assume that ``damo`` is on +https://github.com/damonitor/damo. The examples below assume that ``damo`` is on your ``$PATH``. It's not mandatory, though. Because DAMO is using the sysfs interface (refer to :doc:`usage` for the diff --git a/Documentation/admin-guide/mm/damon/usage.rst b/Documentation/admin-guide/mm/damon/usage.rst index 26df6cfa4441..d9be9f7caa7d 100644 --- a/Documentation/admin-guide/mm/damon/usage.rst +++ b/Documentation/admin-guide/mm/damon/usage.rst @@ -7,19 +7,19 @@ Detailed Usages DAMON provides below interfaces for different users. - *DAMON user space tool.* - `This `_ is for privileged people such as + `This `_ is for privileged people such as system administrators who want a just-working human-friendly interface. Using this, users can use the DAMON’s major features in a human-friendly way. It may not be highly tuned for special cases, though. For more detail, please refer to its `usage document - `_. + `_. - *sysfs interface.* :ref:`This ` is for privileged user space programmers who want more optimized use of DAMON. Using this, users can use DAMON’s major features by reading from and writing to special sysfs files. Therefore, you can write and use your personalized DAMON sysfs wrapper programs that reads/writes the sysfs files instead of you. The `DAMON user space tool - `_ is one example of such programs. + `_ is one example of such programs. - *Kernel Space Programming Interface.* :doc:`This ` is for kernel space programmers. Using this, users can utilize every feature of DAMON most flexibly and efficiently by @@ -543,7 +543,7 @@ memory rate becomes larger than 60%, or lower than 30%". :: # echo 300 > watermarks/low Please note that it's highly recommended to use user space tools like `damo -`_ rather than manually reading and writing +`_ rather than manually reading and writing the files as above. Above is only for an example. .. _tracepoint: diff --git a/Documentation/mm/damon/design.rst b/Documentation/mm/damon/design.rst index 8730c246ceaa..f9c50525bdbf 100644 --- a/Documentation/mm/damon/design.rst +++ b/Documentation/mm/damon/design.rst @@ -586,7 +586,7 @@ API, and return the results to the user-space. The ABIs are designed to be used for user space applications development, rather than human beings' fingers. Human users are recommended to use such user space tools. One such Python-written user space tool is available at -Github (https://github.com/awslabs/damo), Pypi +Github (https://github.com/damonitor/damo), Pypi (https://pypistats.org/packages/damo), and Fedora (https://packages.fedoraproject.org/pkgs/python-damo/damo/). diff --git a/Documentation/mm/damon/maintainer-profile.rst b/Documentation/mm/damon/maintainer-profile.rst index feccf6a0f6c3..048b78e6d989 100644 --- a/Documentation/mm/damon/maintainer-profile.rst +++ b/Documentation/mm/damon/maintainer-profile.rst @@ -91,9 +91,9 @@ list (damon@lists.linux.dev). .. [1] https://git.kernel.org/akpm/mm/h/mm-unstable .. [2] https://git.kernel.org/sj/h/damon/next .. [3] https://git.kernel.org/akpm/mm/h/mm-stable -.. [4] https://github.com/awslabs/damon-tests/blob/master/corr/run.sh#L49 -.. [5] https://github.com/awslabs/damon-tests/blob/master/corr/tests/kunit.sh -.. [6] https://github.com/awslabs/damon-tests/tree/master/corr -.. [7] https://github.com/awslabs/damon-tests/tree/master/perf +.. [4] https://github.com/damonitor/damon-tests/blob/master/corr/run.sh#L49 +.. [5] https://github.com/damonitor/damon-tests/blob/master/corr/tests/kunit.sh +.. [6] https://github.com/damonitor/damon-tests/tree/master/corr +.. [7] https://github.com/damonitor/damon-tests/tree/master/perf .. [8] https://github.com/damonitor/hackermail .. [9] https://docs.google.com/document/d/1v43Kcj3ly4CYqmAkMaZzLiM2GEnWfgdGbZAH3mi2vpM/edit?usp=sharing diff --git a/Documentation/translations/zh_CN/admin-guide/mm/damon/start.rst b/Documentation/translations/zh_CN/admin-guide/mm/damon/start.rst index bf21ff84f396..cff7b6f98c59 100644 --- a/Documentation/translations/zh_CN/admin-guide/mm/damon/start.rst +++ b/Documentation/translations/zh_CN/admin-guide/mm/damon/start.rst @@ -15,7 +15,7 @@ 本文通过演示DAMON的默认用户空间工具，简要地介绍了如何使用DAMON。请注意，为了简洁 起见，本文档只描述了它的部分功能。更多细节请参考该工具的使用文档。 -`doc `_ . +`doc `_ . 前提条件 @@ -31,7 +31,7 @@ ------------ 在演示中，我们将使用DAMON的默认用户空间工具，称为DAMON Operator（DAMO）。它可以在 -https://github.com/awslabs/damo找到。下面的例子假设DAMO在你的$PATH上。当然，但 +https://github.com/damonitor/damo找到。下面的例子假设DAMO在你的$PATH上。当然，但 这并不是强制性的。 因为DAMO使用了DAMON的sysfs接口（详情请参考:doc:`usage`），你应该确保 diff --git a/Documentation/translations/zh_CN/admin-guide/mm/damon/usage.rst b/Documentation/translations/zh_CN/admin-guide/mm/damon/usage.rst index da2745464ece..50f6f0b6bf11 100644 --- a/Documentation/translations/zh_CN/admin-guide/mm/damon/usage.rst +++ b/Documentation/translations/zh_CN/admin-guide/mm/damon/usage.rst @@ -16,16 +16,16 @@ DAMON 为不同的用户提供了下面这些接口。 - *DAMON用户空间工具。* - `这 `_ 为有这特权的人， 如系统管理员，希望有一个刚好 + `这 `_ 为有这特权的人， 如系统管理员，希望有一个刚好 可以工作的人性化界面。 使用它，用户可以以人性化的方式使用DAMON的主要功能。不过，它可能不会为特殊情况进行高度调整。 它同时支持虚拟和物理地址空间的监测。更多细节，请参考它的 `使用文档 - `_。 + `_。 - *sysfs接口。* :ref:`这 ` 是为那些希望更高级的使用DAMON的特权用户空间程序员准备的。 使用它，用户可以通过读取和写入特殊的sysfs文件来使用DAMON的主要功能。因此，你可以编写和使 用你个性化的DAMON sysfs包装程序，代替你读/写sysfs文件。 `DAMON用户空间工具 - `_ 就是这种程序的一个例子 它同时支持虚拟和物理地址 + `_ 就是这种程序的一个例子 它同时支持虚拟和物理地址 空间的监测。注意，这个界面只提供简单的监测结果 :ref:`统计 `。对于详细的监测 结果，DAMON提供了一个:ref:`跟踪点 `。 - *debugfs interface.* @@ -332,7 +332,7 @@ tried_regions// # echo 500 > watermarks/mid # echo 300 > watermarks/low -请注意，我们强烈建议使用用户空间的工具，如 `damo `_ ， +请注意，我们强烈建议使用用户空间的工具，如 `damo `_ ， 而不是像上面那样手动读写文件。以上只是一个例子。 debugfs接口 diff --git a/Documentation/translations/zh_TW/admin-guide/mm/damon/start.rst b/Documentation/translations/zh_TW/admin-guide/mm/damon/start.rst index 1822956be0e0..57d36bfbb1b3 100644 --- a/Documentation/translations/zh_TW/admin-guide/mm/damon/start.rst +++ b/Documentation/translations/zh_TW/admin-guide/mm/damon/start.rst @@ -15,7 +15,7 @@ 本文通過演示DAMON的默認用戶空間工具，簡要地介紹瞭如何使用DAMON。請注意，爲了簡潔 起見，本文檔只描述了它的部分功能。更多細節請參考該工具的使用文檔。 -`doc `_ . +`doc `_ . 前提條件 @@ -31,7 +31,7 @@ ------------ 在演示中，我們將使用DAMON的默認用戶空間工具，稱爲DAMON Operator（DAMO）。它可以在 -https://github.com/awslabs/damo找到。下面的例子假設DAMO在你的$PATH上。當然，但 +https://github.com/damonitor/damo找到。下面的例子假設DAMO在你的$PATH上。當然，但 這並不是強制性的。 因爲DAMO使用了DAMON的sysfs接口（詳情請參考:doc:`usage`），你應該確保 diff --git a/Documentation/translations/zh_TW/admin-guide/mm/damon/usage.rst b/Documentation/translations/zh_TW/admin-guide/mm/damon/usage.rst index 7464279f9b7d..fbbbbad59ee4 100644 --- a/Documentation/translations/zh_TW/admin-guide/mm/damon/usage.rst +++ b/Documentation/translations/zh_TW/admin-guide/mm/damon/usage.rst @@ -16,16 +16,16 @@ DAMON 爲不同的用戶提供了下面這些接口。 - *DAMON用戶空間工具。* - `這 `_ 爲有這特權的人， 如系統管理員，希望有一個剛好 + `這 `_ 爲有這特權的人， 如系統管理員，希望有一個剛好 可以工作的人性化界面。 使用它，用戶可以以人性化的方式使用DAMON的主要功能。不過，它可能不會爲特殊情況進行高度調整。 它同時支持虛擬和物理地址空間的監測。更多細節，請參考它的 `使用文檔 - `_。 + `_。 - *sysfs接口。* :ref:`這 ` 是爲那些希望更高級的使用DAMON的特權用戶空間程序員準備的。 使用它，用戶可以通過讀取和寫入特殊的sysfs文件來使用DAMON的主要功能。因此，你可以編寫和使 用你個性化的DAMON sysfs包裝程序，代替你讀/寫sysfs文件。 `DAMON用戶空間工具 - `_ 就是這種程序的一個例子 它同時支持虛擬和物理地址 + `_ 就是這種程序的一個例子 它同時支持虛擬和物理地址 空間的監測。注意，這個界面只提供簡單的監測結果 :ref:`統計 `。對於詳細的監測 結果，DAMON提供了一個:ref:`跟蹤點 `。 - *debugfs interface.* @@ -332,7 +332,7 @@ tried_regions// # echo 500 > watermarks/mid # echo 300 > watermarks/low -請注意，我們強烈建議使用用戶空間的工具，如 `damo `_ ， +請注意，我們強烈建議使用用戶空間的工具，如 `damo `_ ， 而不是像上面那樣手動讀寫文件。以上只是一個例子。 debugfs接口 From patchwork Mon Aug 26 01:57:40 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 13776957 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 65797C5320E for ; Mon, 26 Aug 2024 01:57:51 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 4EB7E6B02D6; Sun, 25 Aug 2024 21:57:50 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 4971F6B02D7; Sun, 25 Aug 2024 21:57:50 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 3ACAA6B02D8; Sun, 25 Aug 2024 21:57:50 -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 1AB2E6B02D6 for ; Sun, 25 Aug 2024 21:57:50 -0400 (EDT) Received: from smtpin25.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay06.hostedemail.com (Postfix) with ESMTP id C3B43A86E8 for ; Mon, 26 Aug 2024 01:57:49 +0000 (UTC) X-FDA: 82492735458.25.FD3D152 Received: from nyc.source.kernel.org (nyc.source.kernel.org [147.75.193.91]) by imf08.hostedemail.com (Postfix) with ESMTP id 26903160014 for ; Mon, 26 Aug 2024 01:57:47 +0000 (UTC) Authentication-Results: imf08.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=OfNyueGh; spf=pass (imf08.hostedemail.com: domain of sj@kernel.org designates 147.75.193.91 as permitted sender) smtp.mailfrom=sj@kernel.org; dmarc=pass (policy=quarantine) header.from=kernel.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1724637384; 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=vaFF2WzE4QK0KQ5Ku/TFqwT9Hosh4qJRrlJ/34etDtQ=; b=6Su6gVlgAUDIsJD4C400LNcHcdyLr2sq2lYAHGIxaaB7AtSI9Esw4tEO4rlN5riuyErZJh dB+jBO8i7nLMIlnscw77gFqGb6G87NbjhIhwY/HJVJ84/pzyLZX+8AInUSJ5QL49LE4jjY +ftJU3KjFkvzYDwWKaL2Kq9yjVqDf5o= ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1724637384; a=rsa-sha256; cv=none; b=3KhX2eHrDctxh9ncihueBm9+hTsBn/NHEVCMeMz2TZNB7kgzCAr0FAQ1PBnIeVnziTNmOo gQIdEpGm9M+iECvpH54URfE5UKXlWjL/0DixOQ/D4COMTc0zHBB0cIHa1yrfWjSrwQEytX uQEpGuM0frN1doQIvgJO36VdR2acnYw= ARC-Authentication-Results: i=1; imf08.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=OfNyueGh; spf=pass (imf08.hostedemail.com: domain of sj@kernel.org designates 147.75.193.91 as permitted sender) smtp.mailfrom=sj@kernel.org; dmarc=pass (policy=quarantine) header.from=kernel.org Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by nyc.source.kernel.org (Postfix) with ESMTP id A8FC5A40E13; Mon, 26 Aug 2024 01:57:40 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 95BDAC4DDE7; Mon, 26 Aug 2024 01:57:46 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1724637467; bh=JVZ1e15QPo3CgnpjsPGBbluDVYbC60RWJ4aEogp07ss=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=OfNyueGhx4LJPERlgBY/8ljixzNlYaP6x+v7mrQF3pEFh1vH2BH1uzIniEs9BONBa +vRBGyd5q5EpPpmXk+HQry3XWD5rQM5gduU/chYoHMeAWKyS9/JdZfUW6BELZIwz8L z01sJRGzJO61umKvrHWW9vuszhrsP/rDu1tcmxGM9rRFD4KIOgis54rqupDibMfbu4 73jczuSe17BeoPEh3O4dKZagTFD2PBOOvVZTGdmFf6etQgLmvSGHsTq9jfIe785d22 G1gnWWPVvFbSopKyYnKwLZrZfn1WNWNlkGwQbDb/YIcgT8QAE2gVCIT8F6cA5G395K YM91Psts9QqJA== 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 2/3] Docs/damon/maintainer-profile: add links in place Date: Sun, 25 Aug 2024 18:57:40 -0700 Message-Id: <20240826015741.80707-3-sj@kernel.org> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20240826015741.80707-1-sj@kernel.org> References: <20240826015741.80707-1-sj@kernel.org> MIME-Version: 1.0 X-Rspamd-Queue-Id: 26903160014 X-Stat-Signature: kd53x8w1btbfbyby768myf3enotoofms X-Rspamd-Server: rspam09 X-Rspam-User: X-HE-Tag: 1724637467-140101 X-HE-Meta: U2FsdGVkX1/JuBYZzqnV+RScgx8Q4Ovy8Ut90nJaiDWdrYBW9nVhVMFpMV+ibZ22WGgpzrCMh68JBtltJ8+ypNiWTW0cH3d75G/hOqNKNve7ydSnp/1ed4X3i5n9NqQ28skeQN2+LXpsNyrmw4srG5TASRglUnVwgHUrlplPa1OvoBTJZJf/NfmwaceGwXv/ilo5nmYGzXhpq6sz4nod9YPsT8fTrcMrvY4OcgCIA8lbU2vHKiJaV8Xd4gfora+qxLFjwdHCo7hHKzfp0Sil+AD4doplcYIvi5ELwCdjxEVy1aBVcAGWjYC2c70fLlcrNl+0RAcPPmzI5mHMBL1OhpMod6A2psLBcYCTZdSCLt3jfhR1hBuDT545b2BGqf30eyrwlYnWrZ92r0XPJBYFbsepwFSvLQFurvxIKU4MbIWnH4nyc+W6f4Daa3DFc5TIvGk1dvkSNizRMNdNcz5NczUmuY3oy38xLYKSbqrrEpi9si4US105gxD2I3/99K1dEamvrp9ehP1nK48DxFkAE+yz7qwQf6inJh6mJNE6hiDq+aRWvVyKs1W23aixssX6WRS5cAEKbsjk0aTQj5veSyzTx6ap7GkPGVQCbHjVlyPoTavYFB/MkioiXnYvkKEhfxRzSs3l4tDUlDgF82NTabGqBA25bI4Dfu0AAhRBV+e1x777L4rxhjStTZktsI+dAJFQXSPZL79XqoCicnpJYg867scYjP9XbH+EyayIDOPPVBAIbNoKnVrgybkfa4QZZ9oBu8ODpyOXDIImrquESvVJgr8/sZ02oNAEsCfTOEtAMhtMGjhMtBALPN2jzauqkDREGDUHm0BRG5O0pJb+Iny0TAhhF89/Yu3Psyo5WQ/kd0u8xCQSJ+aIuFD73MMhS/UGdPYCl8CC9r8G0NdikJ4b+tOOT2wKdhlnmlc9Lx3OmcehkQn5zjDnEu9XfCVVVzYTAVy21Dy0EQ8hyrt ir7ld/wM 0MdmnvT1KM1owknNsBlPwXYV78Q1OSHNVH5IkpjUqI0avyvWT9CKm6Jzcbw6mrX3UGm2hXynly29uI3ljuZjtA0BZGffKbT2a67DrZJzSnZ5r9isv42fIQcx9SeTA2FoKg/xoUzbdO9mqKnZo0uvdFhH16h30ZBKSpR+CYcOLJAqQhrEvxM/uhIz1z0OGMf39eIyXzXC2b+kmh1Q+kyBjoMfrvItu3FE0GuHEAhmCDmmj85KXTtDxSo/2Xaa4aQUBpVJjgwi5rZ//QiLCAb54/o7GT11OX4g6O+37aa5Jjkb2Z2x29vJB2mwxujJcSZ4c7F/8lPRXeLAxlsEXj9zJ2quuDmJTEbzx/mQD 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: maintainer-profile.rst for DAMON separates the links and target definitions. It is not really necessary, and only makes the readability worse. At least the definitions need the section title (say, "References"). Just add the links in place on the doc. Signed-off-by: SeongJae Park --- Documentation/mm/damon/maintainer-profile.rst | 84 ++++++++++--------- 1 file changed, 44 insertions(+), 40 deletions(-) diff --git a/Documentation/mm/damon/maintainer-profile.rst b/Documentation/mm/damon/maintainer-profile.rst index 048b78e6d989..3c1b42b062ea 100644 --- a/Documentation/mm/damon/maintainer-profile.rst +++ b/Documentation/mm/damon/maintainer-profile.rst @@ -7,23 +7,27 @@ The DAMON subsystem covers the files that are listed in 'DATA ACCESS MONITOR' section of 'MAINTAINERS' file. The mailing lists for the subsystem are damon@lists.linux.dev and -linux-mm@kvack.org. Patches should be made against the mm-unstable tree [1]_ -whenever possible and posted to the mailing lists. +linux-mm@kvack.org. Patches should be made against the mm-unstable `tree +` whenever possible and posted to +the mailing lists. SCM Trees --------- There are multiple Linux trees for DAMON development. Patches under -development or testing are queued in damon/next [2]_ by the DAMON maintainer. -Sufficiently reviewed patches will be queued in mm-unstable [1]_ by the memory -management subsystem maintainer. After more sufficient tests, the patches will -be queued in mm-stable [3]_ , and finally pull-requested to the mainline by the -memory management subsystem maintainer. - -Note again the patches for mm-unstable tree [1]_ are queued by the memory +development or testing are queued in `damon/next +` by the DAMON maintainer. +Sufficiently reviewed patches will be queued in `mm-unstable +` by the memory management +subsystem maintainer. After more sufficient tests, the patches will be queued +in `mm-stable ` , and finally +pull-requested to the mainline by the memory management subsystem maintainer. + +Note again the patches for mm-unstable `tree +` are queued by the memory management subsystem maintainer. If the patches requires some patches in -damon/next tree [2]_ which not yet merged in mm-unstable, please make sure the -requirement is clearly specified. +damon/next `tree ` which not yet merged +in mm-unstable, please make sure the requirement is clearly specified. Submit checklist addendum ------------------------- @@ -32,18 +36,27 @@ When making DAMON changes, you should do below. - Build changes related outputs including kernel and documents. - Ensure the builds introduce no new errors or warnings. -- Run and ensure no new failures for DAMON selftests [4]_ and kunittests [5]_ . +- Run and ensure no new failures for DAMON `selftests + ` and + `kunittests + `. Further doing below and putting the results will be helpful. -- Run damon-tests/corr [6]_ for normal changes. -- Run damon-tests/perf [7]_ for performance changes. +- Run `damon-tests/corr + ` for normal + changes. +- Run `damon-tests/perf + ` for performance + changes. Key cycle dates --------------- -Patches can be sent anytime. Key cycle dates of the mm-unstable [1]_ and -mm-stable [3]_ trees depend on the memory management subsystem maintainer. +Patches can be sent anytime. Key cycle dates of the `mm-unstable +` and `mm-stable +` trees depend on the memory +management subsystem maintainer. Review cadence -------------- @@ -58,16 +71,17 @@ Mailing tool Like many other Linux kernel subsystems, DAMON uses the mailing lists (damon@lists.linux.dev and linux-mm@kvack.org) as the major communication -channel. There is a simple tool called HacKerMaiL (``hkml``) [8]_ , which is -for people who are not very familiar with the mailing lists based -communication. The tool could be particularly helpful for DAMON community -members since it is developed and maintained by DAMON maintainer. The tool is -also officially announced to support DAMON and general Linux kernel development -workflow. - -In other words, ``hkml`` [8]_ is a mailing tool for DAMON community, which -DAMON maintainer is committed to support. Please feel free to try and report -issues or feature requests for the tool to the maintainer. +channel. There is a simple tool called `HacKerMaiL +` (``hkml``), which is for people who +are not very familiar with the mailing lists based communication. The tool +could be particularly helpful for DAMON community members since it is developed +and maintained by DAMON maintainer. The tool is also officially announced to +support DAMON and general Linux kernel development workflow. + +In other words, `hkml ` is a mailing +tool for DAMON community, which DAMON maintainer is committed to support. +Please feel free to try and report issues or feature requests for the tool to +the maintainer. Community meetup ---------------- @@ -83,17 +97,7 @@ members including the maintainer. The maintainer shares the available time slots, and attendees should reserve one of those at least 24 hours before the time slot, by reaching out to the maintainer. -Schedules and available reservation time slots are available at the Google doc -[9]_ . DAMON maintainer will also provide periodic reminder to the mailing -list (damon@lists.linux.dev). - - -.. [1] https://git.kernel.org/akpm/mm/h/mm-unstable -.. [2] https://git.kernel.org/sj/h/damon/next -.. [3] https://git.kernel.org/akpm/mm/h/mm-stable -.. [4] https://github.com/damonitor/damon-tests/blob/master/corr/run.sh#L49 -.. [5] https://github.com/damonitor/damon-tests/blob/master/corr/tests/kunit.sh -.. [6] https://github.com/damonitor/damon-tests/tree/master/corr -.. [7] https://github.com/damonitor/damon-tests/tree/master/perf -.. [8] https://github.com/damonitor/hackermail -.. [9] https://docs.google.com/document/d/1v43Kcj3ly4CYqmAkMaZzLiM2GEnWfgdGbZAH3mi2vpM/edit?usp=sharing +Schedules and available reservation time slots are available at the Google `doc +`. +DAMON maintainer will also provide periodic reminder to the mailing list +(damon@lists.linux.dev). From patchwork Mon Aug 26 01:57:41 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 13776958 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 A8418C5472F for ; Mon, 26 Aug 2024 01:57:53 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 2C47E6B02D7; Sun, 25 Aug 2024 21:57:51 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 2741E6B02D8; Sun, 25 Aug 2024 21:57:51 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 13E5D6B02D9; Sun, 25 Aug 2024 21:57:51 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0012.hostedemail.com [216.40.44.12]) by kanga.kvack.org (Postfix) with ESMTP id E834B6B02D7 for ; Sun, 25 Aug 2024 21:57:50 -0400 (EDT) Received: from smtpin24.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay01.hostedemail.com (Postfix) with ESMTP id A10681C31E9 for ; Mon, 26 Aug 2024 01:57:50 +0000 (UTC) X-FDA: 82492735500.24.F2D0CD0 Received: from nyc.source.kernel.org (nyc.source.kernel.org [147.75.193.91]) by imf21.hostedemail.com (Postfix) with ESMTP id 0B0611C0006 for ; Mon, 26 Aug 2024 01:57:48 +0000 (UTC) Authentication-Results: imf21.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=iOeVL12L; spf=pass (imf21.hostedemail.com: domain of sj@kernel.org designates 147.75.193.91 as permitted sender) smtp.mailfrom=sj@kernel.org; dmarc=pass (policy=quarantine) header.from=kernel.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1724637384; 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=PvGEILY+xMUBcaARTVB2Gtu/HSZvV/TErYAmd4hYpOg=; b=YBhpD+GjGIBzwzxdQTasn5gHzslooBoLh01amF4L5Mt2h8lUB2CJCeI/wsj36hgmn9gnkm I5zjlsKIF+g611rc7YXHcnfxFv9cjnhCb3QqGjPwBDrwiJ1DSrKbNpqEluDBVSUGo26KJ3 t4fpvIaYLPsewexWzsy/ZbJqq5zgyTs= ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1724637384; a=rsa-sha256; cv=none; b=aee20TiLWovCAdX3327feA38GJYhLNUznnRp3GgZd+KKeknb2x0t8mX/E5D32EJkEiLeyL +bXAmm5W/k0+4pOD0TNsA7ANIdJCWEFABpFBdqq4t/UmbUUIkSPZX0NokvDH4PudHTXLdF AIYN/VLAe3Xy+c/YYEpgPRiBogTd15o= ARC-Authentication-Results: i=1; imf21.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=iOeVL12L; spf=pass (imf21.hostedemail.com: domain of sj@kernel.org designates 147.75.193.91 as permitted sender) smtp.mailfrom=sj@kernel.org; dmarc=pass (policy=quarantine) header.from=kernel.org Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by nyc.source.kernel.org (Postfix) with ESMTP id 8697CA40E14; Mon, 26 Aug 2024 01:57:41 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 5EB52C4DDEF; Mon, 26 Aug 2024 01:57:47 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1724637467; bh=gea9mUAXiEJkvTAvBc5bm1Bd90hC20jz8ChzK7BjWCU=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=iOeVL12LSOwQyKI5vW9FASmShYc2pnkTCsfW/YGxAVkAI7Q1Hs8vEzztLaI4Yo/x0 VT4HjMMKdJKxs9xwCsmjCSHaQCf0gm+xpyibQd1NE1Xfem+7GHdkOQXCtJTKBKgvhR NyTeX0Sx6v4bBmdXpJBGXzicTwwjA+np+dJp8pGp5WDRQLTEMmUvdQOQiMG0VNxIfj qVEN4uvuvUVoReoxMPTxwfVTeKpumhIraPQE+sv7cXLfaiUFeZy/ygRQRiARJ3mdYU 1TcB+D/xP+78+cjI9hcghS6FvhdQN0+OJ3XeDltb/Fs5sKI6wHLgM5M5XZuzyASVWD mbWMYZvOGh8/w== 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/3] Docs/damon/maintainer-profile: document Google calendar for bi-weekly meetups Date: Sun, 25 Aug 2024 18:57:41 -0700 Message-Id: <20240826015741.80707-4-sj@kernel.org> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20240826015741.80707-1-sj@kernel.org> References: <20240826015741.80707-1-sj@kernel.org> MIME-Version: 1.0 X-Rspam-User: X-Rspamd-Server: rspam04 X-Rspamd-Queue-Id: 0B0611C0006 X-Stat-Signature: rby6hgm5oymzxu3n3yedopebskf3rwdw X-HE-Tag: 1724637468-844349 X-HE-Meta: U2FsdGVkX1+teNQgfiHqia2j7mI3zXF1oMFs/2fGVGCxkN3ulmESTufo09+n6SUgSTlFYk/uww4PvRDVU+WLMJFq6EUE9MWj1+nWIKJxVKKMxXuaxgd4Jh3wlpMcjgPz4wYmB7AOU1OjGVdTv84/7frN39tVylRY4Z4dhm+I54eqwHfNW/Y/l8pToZWxwgjf6VUw3vHK2joWTzxXGv/670jay1Dugh/TcYqGeycup7meyTd6W6aMemZXadeAMOu+cJKxRq3F4JC9Sac6tscmcXkxuktZwxzXDdUCNrD1w6PXQ7DXO+mVigFn20LL0/WxD8lWBgtuNsXOPRvYKHFK039TyeSCAooGxAleAnEUbGg0mQg0OulD6cT35MsYa7HPpqQVFH/ScKOu0iJ716OJDUfOW2STUe9wrrd2yeaAMyjpJIk4E7t7qfaG+0hpT4kg1Rjv8u3eQqmujzNj5/Hch9bY1WalW+9lhBZhDgTFPK84mfX9ERgCZc/8vUq89DzNqVuGB9MKTDV9N6CY4OomyAKn7O+cu5v3NbvptoWduq4ygYDB9uvdwHkPquwEND2pyZee+y0fD3cnJ/xrEfcSUt3sa5BA+MDRwfzgvsLi+0LEMCnLYrzlpZOmp6i1k+ZiBxOM78lfpjylG9iGjeERRvDSRv3Acdl+93iiOHSDo35bxQadLre6+yC0Kzna52fIfTDAajSPRz9VHij4Zd/4p/EsbjuVMIpAyALhiW7aHoXwCKR5W5TkYUuA3x7StC8pVXkKsxLIjXhleMnNw3Rt00hgTwg9OpfKHpBPIFDLoHkzEI5Zjtk2DVWZ2vtG3jiJHfzaq1tmYRaO91IuO9RyEu7ecnqeo0VVEoToSB13qLlq6aeagECvEVPpiEwHtTDzZ/r2+IKAgGCwgXjtlh2iE2z+ZbqNoA9XJGLXd/jj7ApdoEIwuxoR1wz1U9cRYbPuMBPnVwMVl39+Q/bUIin n6B7QKu4 kyMM+DvCIcmT8l0XcLlActVDVP387rFsTJzsgihQoL5mA1S1CVBj+coULWD+LdfpdNB8fmNVZ0eHDN4gT8AS3hIuIp3/4LutJjqilZTYZVBiHLPeqy6NNtUWfenfihfyXSaQizBRH/2E4Z4rHYLjf9/rYCcUsK4xK+uL2ZYBwJVzNUDRirCPRzQV9WYUF1mP7qLHivP6Nb6Gjqt3CNtk3znLvfLkLs2UIafvtJ8U1KSJJBZItLiFZcxEpfr9ftjrW2tLpL+Edy+aK9NCIDTHdvkL6/SHxkhmZPIFF X-Bogosity: Ham, tests=bogofilter, spamicity=0.002028, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: List-Subscribe: List-Unsubscribe: We added a public Google calendar for easy sharing of DAMON bi-weekly meetups[1]. Add it to the official document for a better visibility. [1] https://lore.kernel.org/all/20240717235812.53087-1-sj@kernel.org/ Signed-off-by: SeongJae Park --- Documentation/mm/damon/maintainer-profile.rst | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/Documentation/mm/damon/maintainer-profile.rst b/Documentation/mm/damon/maintainer-profile.rst index 3c1b42b062ea..2365c9a3c1f0 100644 --- a/Documentation/mm/damon/maintainer-profile.rst +++ b/Documentation/mm/damon/maintainer-profile.rst @@ -99,5 +99,7 @@ time slot, by reaching out to the maintainer. Schedules and available reservation time slots are available at the Google `doc `. -DAMON maintainer will also provide periodic reminder to the mailing list -(damon@lists.linux.dev). +There is also a public Google `calendar +` +that has the events. Anyone can subscribe it. DAMON maintainer will also +provide periodic reminder to the mailing list (damon@lists.linux.dev).