From patchwork Mon Jul 1 19:05:09 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 13718554 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 C2A85C2BD09 for ; Mon, 1 Jul 2024 19:05:23 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 8D4566B0093; Mon, 1 Jul 2024 15:05:22 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 883F06B0095; Mon, 1 Jul 2024 15:05:22 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 771D46B0096; Mon, 1 Jul 2024 15:05:22 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0014.hostedemail.com [216.40.44.14]) by kanga.kvack.org (Postfix) with ESMTP id 50CAA6B0095 for ; Mon, 1 Jul 2024 15:05:22 -0400 (EDT) Received: from smtpin11.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay07.hostedemail.com (Postfix) with ESMTP id F200816144E for ; Mon, 1 Jul 2024 19:05:21 +0000 (UTC) X-FDA: 82292112042.11.6778EF8 Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by imf20.hostedemail.com (Postfix) with ESMTP id 527241C0021 for ; Mon, 1 Jul 2024 19:05:20 +0000 (UTC) Authentication-Results: imf20.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b="QLr+TKX/"; dmarc=pass (policy=none) header.from=kernel.org; spf=pass (imf20.hostedemail.com: domain of sj@kernel.org designates 139.178.84.217 as permitted sender) smtp.mailfrom=sj@kernel.org ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1719860702; a=rsa-sha256; cv=none; b=FjXfllIHwhOjVOJaUF8dmts4o/Xcg5w3z5f+TKNhXMF4a3NUK+MJJKO6HgVKK/8UWPy/SE e01VBK2q4QZu0aR/Z2lssWmV19lWpyV+daUrXmvMYzTJQlHN1fjYRW6xojJ64jKfoeaGsf n9zGn3X/aE/7+tjnPbVW7szPKtt9SSE= ARC-Authentication-Results: i=1; imf20.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b="QLr+TKX/"; dmarc=pass (policy=none) header.from=kernel.org; spf=pass (imf20.hostedemail.com: domain of sj@kernel.org designates 139.178.84.217 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=1719860702; 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=+lz86w/hKAEDC7Hz1zAhvAFKmzZiexwVEHrENpbnkb4=; b=rNaIs/lRWmSxXxChSkpA3myUF/bS/RO6mkc3tM+tsjParNjwZFbRtm6SddqC0MA+ldhJK7 0m3CFsP0kZLNvaOg6W8+EJIHf+tswx39XtNzUUuudtcdCaUFZM/3i1BeilgXdtvwGjFO19 iL1E1PKqWYyuUkLGm14zFVw4KMSP73Q= Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by dfw.source.kernel.org (Postfix) with ESMTP id 773AE61772; Mon, 1 Jul 2024 19:05:19 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 9C798C4AF0A; Mon, 1 Jul 2024 19:05:18 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1719860719; bh=naE5jRrwQozMx1LfncydeIdqJAI3pVBg0a8pa+E5Cmc=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=QLr+TKX/1TaBS8L+M+VJkO8JaWcJCi2qyVyaxj0qkfF29zNzZFuEWhR3IIOAv6ySp 79IOZqN1JDZ8T22t1yKTwXWCvVLVpwIrdRevmdUgQOQnuhrFRif/OHJ+hzP9ceXh/Q L0ZjlWlBuUpgTNongXL0LJm8vk2dJn1nslWI2TIW23AcgsylpGbtcYCxOrso0utVlq ightxSGV+ZvXdRAAiECp1hWgFLQK0UQrzQVtmTNRj4CVPosaJlsCXR5d77OGxF5MQT yQiinpmrv7rV32Oycm/6foquAWvCxOsfppGZbi81xpERTFKeAs2L/iMeBIxIj6KmpW rmNg2QnFNCH+A== From: SeongJae Park To: Andrew Morton Cc: SeongJae Park , Suren Baghdasaryan , Kent Overstreet , Jonathan Corbet , linux-mm@kvack.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH 1/4] Docs/mm/allocation-profiling: mark 'Theory of operation' as chapter Date: Mon, 1 Jul 2024 12:05:09 -0700 Message-Id: <20240701190512.49379-2-sj@kernel.org> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20240701190512.49379-1-sj@kernel.org> References: <20240701190512.49379-1-sj@kernel.org> MIME-Version: 1.0 X-Rspamd-Server: rspam12 X-Rspamd-Queue-Id: 527241C0021 X-Stat-Signature: o7zs1fost5quk7ziu5zq3cppjy5z6ttg X-Rspam-User: X-HE-Tag: 1719860720-920038 X-HE-Meta: U2FsdGVkX19PGqGrMwynRXtjuE8gR/JdULReDuiJQC8lNlS/wnOJRHa9SwmcJn6Bs7vC/ao8kd6/Hp9Dcu+l81jnGduS4biugOGvB5/qnqZzLxNKkOYlkjfMCQyj32B+l77OusQ30qPWTPmNV0GlJ2ozLmRroLSQ1cm6Qee93JALNhGeiiTgvMoWZJdX52BeCNd/S2pdOLIA0+goN5DqUwodL6lBPndxlrIthMC7RFIlaQZyZDe1YnfpyqJfvkD4x8951p23ob2lRF+CIBY5CPtXKyCdiP5V5Yp3uDGjt7u8T9gUwa339Xkyq+Ceax70iiUdVxWWECoxPPsMQlJigCoe2OTNxu7aGU/8S0IktauAtGoaNl3lhTp5A84n2aqLBjwc6bkZXd3lEwRxs5sDBjDTOVSoAG/WlyQ9+RrqxYSwiOH5SrnlJg5btkrmlTfuqYNlpCrlAOWnIIWBV/IqfncxYiXjIkI1IhvzjMRup4FXSQB++Lbk57EC1HRag7Soz4tEXpO06LSdCkDtk78Fkzkh8aMyqXMLOAXcs5Vl5AFo0o4BBsezUQh71SaHmfXEUfGINcmnKclA7Ztod8EMvM41QbXuhvcJbe2Yr2lTRg9covlKgbaIiIB9juEhl2lM4EqoAKr105Pne0c8g36SpvWzPdGsqd1wypy+wiO2xgbP/Gtp7KUqktl9ZSnQ9E6lmAhEXnj7+kWpNxRQmdX5pKLTr1Hye++tnpZ4JIAtvWKI+y3AVz6G9lxWahwafKnUldGhi9gl0RxXE4VDPFHWLOjv93XhMCq9Z4BBBI4f4+uoDWyE3enM1aAaGg0HU2n9fcm5+60qWUuSVOTpCHDbsKHHyN99/os9bec7G0iGD057hsWCL6jaDtQNZIfAICaA0L8cPlMCGxSKuWbHy/7jlIYDssAyh6PaF4BRtFcBNXPI4LI16JPm+DitlZsoZO1T9qZwxCv946jwebKQzTE 15BABfZ9 BpMQ158nTfYAlMGvDWX2gmE1ynvcRVZHEz8E8Q6ms/jvuqreuB+3PjPYGVmaQUP1NQNLrUDiof3dWjZ469oyxg4SAuUGxZnq9/k5FsSgV4Vi1lFD2uztNsRGxBWOruND3nZkY0DTkqDeMvY5yVw4xQOXlmp6EcSQbEQCQ+LyWTqfOpb02yMzz3D7lEdyFMaGsQ+zwnGbRIZZPQUwuNMhKrI+MBYC0Y6K+FnRo/xoa122uEQU= 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: 'Theory of operation' part of allocation-profiling document is apparently a chapter. However, it is mistakenly marked as a document title. As a result, rendered mm document index page shows two items for the document. Fix it to be marked as a chapter. Signed-off-by: SeongJae Park Acked-by: Suren Baghdasaryan --- Documentation/mm/allocation-profiling.rst | 1 - 1 file changed, 1 deletion(-) diff --git a/Documentation/mm/allocation-profiling.rst b/Documentation/mm/allocation-profiling.rst index d3b733b41ae6..ffd6655b7be2 100644 --- a/Documentation/mm/allocation-profiling.rst +++ b/Documentation/mm/allocation-profiling.rst @@ -46,7 +46,6 @@ Example output:: 55M 4887 mm/slub.c:2259 func:alloc_slab_page 122M 31168 mm/page_ext.c:270 func:alloc_page_ext -=================== Theory of operation =================== From patchwork Mon Jul 1 19:05:10 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 13718555 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 A7061C3065A for ; Mon, 1 Jul 2024 19:05:25 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 3A41E6B0095; Mon, 1 Jul 2024 15:05:23 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 3558E6B0096; Mon, 1 Jul 2024 15:05:23 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 1A8ED6B0098; Mon, 1 Jul 2024 15:05:23 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0013.hostedemail.com [216.40.44.13]) by kanga.kvack.org (Postfix) with ESMTP id E339C6B0095 for ; Mon, 1 Jul 2024 15:05:22 -0400 (EDT) Received: from smtpin27.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay06.hostedemail.com (Postfix) with ESMTP id A0070A48C2 for ; Mon, 1 Jul 2024 19:05:22 +0000 (UTC) X-FDA: 82292112084.27.8803906 Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by imf12.hostedemail.com (Postfix) with ESMTP id EA18040009 for ; Mon, 1 Jul 2024 19:05:20 +0000 (UTC) Authentication-Results: imf12.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=H7V43KYs; spf=pass (imf12.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=1719860709; a=rsa-sha256; cv=none; b=aQ0T00+vVTudi0j3rk3pzxTP66MayIoTszcr5B1LljFCgpzkhh5NSrXxjbjo7kr4J6Qhph WrshT2xY+7ulD5CXZiu5vfLN9KmL9xUA5fHrrbgYFueRK3uA4gocu985LIvIwuDuXdghhg x1YrS36fxL3MV5t3Ni5QqTmW+DUTrc0= ARC-Authentication-Results: i=1; imf12.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=H7V43KYs; spf=pass (imf12.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=1719860709; 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=1b9inRLAdIIVuwr1Or0OLeVrWTf8NwBMQKAPYOqR+7s=; b=WbOib8huVXNJeLsoPJ/5q3lz3yyPuPoO5G1gSpzxgfTvtGMka68SXLiPrWqb9AT92/334U x+g8T41nE2prGByg7PO+M3tyymR/l343ev43UPneP3GEjr3N7pLz1zoLDZemDub1KM7HAz YczrkYbBSA8VXFdMXSRs5+kG0b1DEfM= Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by dfw.source.kernel.org (Postfix) with ESMTP id F250F61775; Mon, 1 Jul 2024 19:05:19 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 60542C116B1; Mon, 1 Jul 2024 19:05:19 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1719860719; bh=rKMcJwDzY3ZuJksWzSHVDhDaEID8BzH9D1KxvuRmlmU=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=H7V43KYsH2R5cvdzJyDITL0e/NyhyNWt1Rg63WDxyYgnHtSV7YiMcUm2fecBl0eRB QOO9o3MX07dA0NhzTgO6YBA4cGHgLK3xI+N77S6xGOALbtkSDJB13SctuGbgohycHo 4VbV1AcmL1IWBs+ZqUyKSq2KIWBTNFGb1oGs1IMkYL9mVEyTT02gkbuuKce6VKGDlq dyXSB04HQjBH7r61rO9YeS/zY59IJ+IgLX8llwA2nFXxzpzMQJsAIzY1jacuirZqiT rSUOJ4xpykCeB7KbfbxL0NBIpUlmwrcqN9ZPxn+1/BK2rBV4id9ywOu9Ip7RKrayP9 wW36ydYCUMdsA== From: SeongJae Park To: Andrew Morton Cc: SeongJae Park , Jonathan Corbet , linux-mm@kvack.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH 2/4] Docs/mm/index: Remove 'Memory Management Guide' chapter marker Date: Mon, 1 Jul 2024 12:05:10 -0700 Message-Id: <20240701190512.49379-3-sj@kernel.org> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20240701190512.49379-1-sj@kernel.org> References: <20240701190512.49379-1-sj@kernel.org> MIME-Version: 1.0 X-Stat-Signature: 5f3ajyj1eyjo78m8un3x1xhkeybaskjm X-Rspamd-Queue-Id: EA18040009 X-Rspam-User: X-Rspamd-Server: rspam10 X-HE-Tag: 1719860720-593604 X-HE-Meta: U2FsdGVkX19Ux7cxkIo+8bksLv4jCyH34O4XWBx8RC75B4jbWdsG0xuZ/OIXGrLgttHF5qmrMJT4P6pvd1DhmEcmsVjLcNIL5rT0DAbzSR0uxjVSMAKaqNpUy7OvP1Yu7bspJiQsJqblri5hPYGzE5wtAzkZAqaFWeM360Wb1r7YpSVyAEyqHL+3WVysYBySCtsmVilLBNliBTDuY4/SiNOtSmUgKqwE+dt2HNoU8uA/DzLLQhLEsvUFU8QJOjBFmyIDm6SFOD3Hu3FAXZkB8oB+ugZ/4rpOeH98AyxOP1+d2UBpnHa/Cu6xrDiIiO4mrD6ct3YLi/1meiLsrJ5WSK/AIHvNS8M9b7PdCvvMfypBtSOdbbFS/W0EKswouKeCsrGRqbW/E9KNuEHXRg8DbNuUvaObKaP3TFemST0AtND1ZDKXH+BqreiOTv6BM/FGBT+dsNNzv3SC/E3oHwvG5uLMyMklDAyLI2HguAoQaPkwLiTlbkXcO1U/pIb0XgaTMn7ysB614/VnZ468AbQZlDrDxS3ZKiU8/SUYPo8nIZiQjumPYEdF+SCn2ig9uGP35jjfk1nFsOhbb9yUC8xFu9UOU5lfcZu+9IYhUQP/PuVk6BWYUsjWedsSjIqsUCO3430ZIJlKaA6QSOSbJo4Oy4q9EXHG8MgLpo77A8ppPOQSHE3tg7Xaqm4JiY90jlNBceKDaN3wNf6/BUzSdv/CmnbDhX4OEA31TlqIb/p+Hd6XX7K6gBsay919bDpbf32uHSSK38nsqQ6aZV6+fQR+VB0NnFfGiiBBfrIbtncYiFGkhE6g2bFZT4x/la2Neo73wqSRXmIGgNpj75mtIXg9Eam12N+GFOXtoiOxWQoFogNvfZXUAekj/pO75qjNKxtBlsB5HeCD9A043UI3DgZUBloIhfFdQ11EWXaUD6jhh2jX9Cs2yNvva/OTF0KTWd7pShcOZ85kMCiFWRbqvjm zIRo/coY u6siKE92NO0pZYl9k3YaKVnkXFV7kKXWPiVBqmINQmc2gyeYxpVwRWOldaITmiOkC0X25hwowrcQv0+Q6iSI3cQ2QHpWXqUH2I5DN5DLQ/UOROaX2H8Jtlqk/I2EoiSiaQsXb6SMYIqAxqXBJyrj1pE0sKNJHElPsY6ZFXD5AmKeTmUQaWP0qHl0EspS4t+9Z1YrTjkBQezmcR2b82miXWVXAU+IgCQXRWhNzdqiO9G0lZmQ= 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: 'Memory Management Guide' chapter aims to be not an additional chapter of the document, but the ultimate single outline of the document. In the sense, marking it as a chapter under the document makes no sense, and the rendered document looks odd. Remove the chapter marker. Signed-off-by: SeongJae Park --- Documentation/mm/index.rst | 3 --- 1 file changed, 3 deletions(-) diff --git a/Documentation/mm/index.rst b/Documentation/mm/index.rst index 48b9b559ca7b..5007815405f1 100644 --- a/Documentation/mm/index.rst +++ b/Documentation/mm/index.rst @@ -2,9 +2,6 @@ Memory Management Documentation =============================== -Memory Management Guide -======================= - This is a guide to understanding the memory management subsystem of Linux. If you are looking for advice on simply allocating memory, see the :ref:`memory_allocation`. For controlling and tuning guides, From patchwork Mon Jul 1 19:05:11 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 13718556 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 71704C3065A for ; Mon, 1 Jul 2024 19:05:28 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id EF1326B0096; Mon, 1 Jul 2024 15:05:23 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id E7A576B0098; Mon, 1 Jul 2024 15:05:23 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id D66566B0099; Mon, 1 Jul 2024 15:05:23 -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 B3A766B0096 for ; Mon, 1 Jul 2024 15:05:23 -0400 (EDT) Received: from smtpin06.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay10.hostedemail.com (Postfix) with ESMTP id 53B27C1D8C for ; Mon, 1 Jul 2024 19:05:23 +0000 (UTC) X-FDA: 82292112126.06.7660DF8 Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by imf30.hostedemail.com (Postfix) with ESMTP id 7EE0A80019 for ; Mon, 1 Jul 2024 19:05:21 +0000 (UTC) Authentication-Results: imf30.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=O06d+nZY; dmarc=pass (policy=none) header.from=kernel.org; spf=pass (imf30.hostedemail.com: domain of sj@kernel.org designates 139.178.84.217 as permitted sender) smtp.mailfrom=sj@kernel.org ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1719860703; a=rsa-sha256; cv=none; b=ob1gFnzVFRer2uiaP+RCefe7swekucKZLZPKX9cAdD7pkeEkQKIWzoUVWVgCBVx/B1kt+Y lYyMk+JgNL1341CDq2C9D6HXz+9mqfGwPKugX4UjAkxCTI1AwveRlONOdMb/+lAUyn1s02 FAXzYkdadddw9NlCjK47wJTU2X0qW0Q= ARC-Authentication-Results: i=1; imf30.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=O06d+nZY; dmarc=pass (policy=none) header.from=kernel.org; spf=pass (imf30.hostedemail.com: domain of sj@kernel.org designates 139.178.84.217 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=1719860703; 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=VFvoGWQKVTXdOlytX3TeHkmv1M2dYteJyQc63wW8+K8=; b=LAB05IEJHNCBfC3HakEKDbCSnDKcZd28Gmeu+4nrrZnan8fT9fyPXoOG240SZK9peHWEOK piOYzli5P2MmYeG80NhSgZoHaFDMIM7irAGAm4OCGSxc76lzYklgpF7luuPUd1UEQOTphO B+wwja9Iw4mGXRQ5N/ntFwToT1ovynA= Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by dfw.source.kernel.org (Postfix) with ESMTP id A64E861767; Mon, 1 Jul 2024 19:05:20 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 05BB2C32781; Mon, 1 Jul 2024 19:05:19 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1719860720; bh=bTyMdjkq+AKoAxGCqmfrGvEJ/bhfbC9NVbA58uF3Mcg=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=O06d+nZYXSie+R7axuFItnJh1jChfKyEno2jo+BIVJ3vTt+DaCGh7iPBH3zmoHkRt o1scDSLXwcPP/2dXowFKicO1b1hpfwCXXPFQpjAsB4st1Va8D34ENoDjZ0pTosmdSd 4XT+NVgmYalVbax2MDnhyFaBtMrIoE0B9JcPp3I7jxptITyF1lC7BqRE5lawmCxtgi yl2Oy2W2+6cpB0aNadUMsfo78oijYGjbMe4CjiV2RfGyytPpqSRb5zIFoO7ggv3apE badyGrmnS28QV9Wrx07VGX4smRa+a77goPG3KmMdG+JxhCyqNazlJk1BaBRAZhKvQi juEastP2T4mNQ== From: SeongJae Park To: Andrew Morton Cc: SeongJae Park , Jonathan Corbet , linux-mm@kvack.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH 3/4] Docs/mm/index: rename 'Legacy Documentation' to 'Unsorted Documentation' Date: Mon, 1 Jul 2024 12:05:11 -0700 Message-Id: <20240701190512.49379-4-sj@kernel.org> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20240701190512.49379-1-sj@kernel.org> References: <20240701190512.49379-1-sj@kernel.org> MIME-Version: 1.0 X-Rspamd-Server: rspam12 X-Rspamd-Queue-Id: 7EE0A80019 X-Stat-Signature: tm5keez3shtjfda846py71ofqr4b76bk X-Rspam-User: X-HE-Tag: 1719860721-137409 X-HE-Meta: U2FsdGVkX18fCljRy7B03wsIdsjWVJdMMt6S4ICQa2k3I9qCnQepjgzP0QspiT49Fl36vGoROkgs3KKPIOJ12XqYE+J8+aGRftkUSz+XS4+manSffT8LzENh3PUy9wgBo0nS1Ixny93rSHQxi24SC6nyEyvQGxJdK2Rnby9jTaONHq14I3w5x8VU5hcFabE+oNpeyZLy3aWvWayAjz8Xn5NJ3X/8D/RuMPfP0Z/emjngXyM4qc7LoT6uz9wW5LG5ZwLKgnRkSQzn5R6FTl+wMLfxWOl2UDv7ZZZ9UidRi5nx1DHx2hkgXcEuSMbrRrHQJW8NBL5NQP1RDuB/lQVW9BMr51F5B/ApsNayqJF1rmrn7llqk5vGVcn/61F7+WcdA9uBZHDD1r4oKXSOEYy/EqnpTY0nFevwPPAy56723otx7Qqp4iDWCG2ghoHPrfNvsngZhcBtF9Pm9no2y4PH+kipIZl2e04s1bnZpjj8Zro0NODgEkKavz/Wia1DedGEb6qt9F3XgyT/eVb4R9DF0vqMxQlbgX0YKZOIp+/rCyLwvyKQzwiL9pGdVDofIDTTmjc6gT4ovB+XH5VS2UM69NoM2ZnRkCWY04L15eDbW/Hr12n4Zs9G3r16wpNcE45s1GGzJ8EULf5Z05EBHT6A0YsvaMiHXrY7y4DCpyW2C9J2zk5UAJh7vhMr3bLLLXA44T30Xbke3pU9JG2JfwaDIDp2xk+pE7m/MYTuf/BzkFwPz9pcETZ4RtbFUIL4WmEx/NZrZxi30wYQHfT6blmyVP9dpMWNfj4Yde75wsXrMgrMkXn8rlrCszoQsoGc/T0eb3g5LeJpYXzf7mXXN+n7VEYeuuH1gofi2IteyEqVmP7eIWjubFNOlYHzKJyxCO8dT/OPscWKJwzRYU6t7mBQIhJiJpKLXSzZ2MyXkEmTna8JlqSdDZyvA/fDOOPh96500tXT6KBS4XKTvQCjL57 b08fBd1b 1IAXK2Uq75bae0KcY/5fAEovGIZcBe1jSraMgx/frIu07DHNBMxqONp/NlRNWB8WiyjXViVjFr5rIDJw8cMPIgKQDqyJBDoTNYPYjUNXlpB0L2cZLonsR/+LduTajXEwnEIS38HAyvw+wJtM1ddyETxuqMDa3a4dIxpdCQjI2APfRTrNihIb/gZ8EFTsTndi2ORHBGhRjzMFQdGtOJIK5XV+D/pjgDhJX05fxMBIPfewsTY4= 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: The intention of 'Legacy Documentation' chapter is to keep the old documents that not yet sorted into the new outline, and encourage new documents to be integrated in the new outline from the beginning. However, the new outline will take some more time to be completed. It has started about two years ago, and still many parts are not yet written. Also, there is no clear guidline for placing each document for all cases, for not only the 'legacy' documents, but also for new documents. For example, memory allocation profiling document has been added to the bottom of the new outline. Apparently it was not following some well-defined guideliens or a result of a discussion. Furthermore, the title ("legacy") makes people feel the documents on the chapter might be outdated or not actively maintained. Rename 'Legacy Documentation' to 'Unsorted Documentation' and remove the description saying it is for 'older' documents. After this change, new documents that not clear enough where it should be placed on the new outline can be added on the chapter while well-defined guidelines or discussion for the new outline is made. Signed-off-by: SeongJae Park --- Documentation/mm/index.rst | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/Documentation/mm/index.rst b/Documentation/mm/index.rst index 5007815405f1..15614df2b989 100644 --- a/Documentation/mm/index.rst +++ b/Documentation/mm/index.rst @@ -25,14 +25,14 @@ see the :doc:`admin guide <../admin-guide/mm/index>`. oom allocation-profiling -Legacy Documentation -==================== +Unsorted Documentation +====================== -This is a collection of older documents about the Linux memory management -(MM) subsystem internals with different level of details ranging from -notes and mailing list responses for elaborating descriptions of data -structures and algorithms. It should all be integrated nicely into the -above structured documentation, or deleted if it has served its purpose. +This is a collection of unsorted documents about the Linux memory management +(MM) subsystem internals with different level of details ranging from notes and +mailing list responses for elaborating descriptions of data structures and +algorithms. It should all be integrated nicely into the above structured +documentation, or deleted if it has served its purpose. .. toctree:: :maxdepth: 1 From patchwork Mon Jul 1 19:05:12 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 13718557 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 EE42FC2BD09 for ; Mon, 1 Jul 2024 19:05:30 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 8AF346B0099; Mon, 1 Jul 2024 15:05:24 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 85F376B009A; Mon, 1 Jul 2024 15:05:24 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 7266A6B009B; Mon, 1 Jul 2024 15:05:24 -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 52C2F6B0099 for ; Mon, 1 Jul 2024 15:05:24 -0400 (EDT) Received: from smtpin30.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay05.hostedemail.com (Postfix) with ESMTP id BCCAE41AF0 for ; Mon, 1 Jul 2024 19:05:23 +0000 (UTC) X-FDA: 82292112126.30.EFF740A Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by imf16.hostedemail.com (Postfix) with ESMTP id 198B6180022 for ; Mon, 1 Jul 2024 19:05:21 +0000 (UTC) Authentication-Results: imf16.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=Ond3pfOd; spf=pass (imf16.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=1719860700; 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=zHy/WfhnIbtayx/b49nTlpjFCaPBe2SXCS8Y0FUHg44=; b=Eb4eZC0RGPAOzNX7HloWAB1zV2UFKmT/oHyyuRe7ULu1RNdqcoKq82iwJEUablwZpVc9qK Q6OzX7oq0nTCIU8MgfzEb5hnZIi9dmVA3mqc8nMEd0Db0Q2k/eTbKQnyL5vqfXXDDeSnVN sIQMRjYGLXywlK2/3qZe6TosUbWqTnM= ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1719860700; a=rsa-sha256; cv=none; b=Dpg4xW4OUX8rlaBxhxNsPq3XseUIPiFctnYVws5bl9/uMSZ5wWO0mfZ3Uylo616qHxM4f/ ztInpaCI6ZnF24UxVy3NfnoZRH7FgeW8eFvvxlEdJl7lDOmRsQAAHNePB3WoytOy/8sMGE 5Wm5WjTw7ZS3RqlxT5emhC+5jP6oSD4= ARC-Authentication-Results: i=1; imf16.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=Ond3pfOd; spf=pass (imf16.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 Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by dfw.source.kernel.org (Postfix) with ESMTP id 4B71261783; Mon, 1 Jul 2024 19:05:21 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id ADD03C4AF0E; Mon, 1 Jul 2024 19:05:20 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1719860721; bh=xlyK5nyt0D8YbvjFhSK/g0n5XLd6zyA4v9JbXgmHEdU=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=Ond3pfOd0S/NWxlwQaITYvTuJeJ1nbQgUqoMr4Yc3wzIoIx36NGQCD4Ki0Dr+Im0S TfRzRwWriVUgej8kH0bRpMFJPsVGxhdzsVtToiRbaEd7kZf38uQITYANoztKilSkJn ajV2vx/oTHEVZhim+obQjVHd9KXfBrFmQg4f5vlGyrjgRgZFBgPnoSVwwsNNUROOgl SOpHMTw05rYMwTnFImQEI/wTVgGCvJVvo8Qx1sVNeTEc8HQj25g1EEmNCgENdpaGlw RxytOZStx3x6RSuBaJDV0fxmCyBKNLWC1YUoI0dQqdlFjkvmIqnqcP59paP9PJL2C/ ZMl3LdAJgsfPw== From: SeongJae Park To: Andrew Morton Cc: SeongJae Park , Jonathan Corbet , linux-mm@kvack.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH 4/4] Docs/mm/index: move allocation profiling document to unsorted documents chapter Date: Mon, 1 Jul 2024 12:05:12 -0700 Message-Id: <20240701190512.49379-5-sj@kernel.org> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20240701190512.49379-1-sj@kernel.org> References: <20240701190512.49379-1-sj@kernel.org> MIME-Version: 1.0 X-Stat-Signature: 8j63iznfsaf8adwse4tqeki8u4dausfn X-Rspamd-Queue-Id: 198B6180022 X-Rspam-User: X-Rspamd-Server: rspam08 X-HE-Tag: 1719860721-437423 X-HE-Meta: U2FsdGVkX1/LtnaWMdEw4yLMkwjJr6HfQNMuEARmx+fwVxEyHdE7jmQabGdP5nWLPqS+02W5pGzpqj+W2reZ/ghuYgYYVlHoFdFk9xp25lHjb0rtGrJL+UbLTVCKeg+o08GuAFJk8vKc7653v0tzKZ/CXY+xXmxz39XyADVcH0rsyQCkyghwT6s7FPeK7nao6l11GgdcX64+i88SU+3MnAqZvxA+2qce3onn5xnov2ai6ZfEuGRgJFs4AuT4OKO7+mXkqrkNafW8j45rM+0IjrV1CsOGLXgPYKGFfL9SC37KoorIi9ggX/G1Ur5pOYMqTps84wINq5477q+B//LXZbgT5crarhujkszN1PLpT8N+PgmMFTIa+h7cL449/hnn9G3yNkftEcydlkCOMqRSPn/57kzh13escYwsWzjCr6k1iJ1vkMPOzn6JdKG6bLCE3EV53zMpKy8Zezexmk6lyT87dm5d+/QyK0VhOGOg1MG8zSsy66l20utF226uIwv/PhjhfpRMvaPt/bpHX6tggZvBhdz1ze6nTIuaKU2LNwZAQSusbQ5jVGFIfSmnV6hI4pRIG88u3/W5bYg+gd68/mU2Uf+VOCc+qixRk8/M2NKWGoud38QCz7HB1MTkORe8lHrNa3uwMDbwJZnjMNn8yEAGuZvCO93HaTeeYYaARv4WLD71L4cudPM0/z6f00AgyskSo6kWzqu+Hij/iSmXYHrnsgQ4qiGi7retxpAEIGtT61Addyfd7gHdQtiTe7+p6XI3/1xAy2e+a4Zh1yScK4BYqSXXG4JOddR2sk6NU7WyFguaj9L5LRFcJ75QoPyVvD7apxocmVGgkJIVYEB4iUlxWZXami9laq8K3OvH2qg9POKoL+iWtaRbt1+ttmO3hQBAnIdojZBDr/9SNLP2ccCItzH6O7AqisRKWeGymmVRBY+kuLEEP5puIJPht7pv6IKL6A7xJeK9/MkK5Ax T5Rzqwjo jYcdeTTI4NgRcZJhpoeijFlJtnQyHzRn2B0WFJiEO0bkVVoc3SusTl2eehx8Sd3AgZWrHxzvr9WorsKKBeCFwz9xwDMLfk1B8Peo/ia4z0MZHoJnYULFUNXgoiKqeDWGhdhCsptBzzNgYIB3RDk2rzFf3t7K1auYqriryykb4c4wqoaaF5w6ZrpfEo82BHpoC9uiG+34ltUvdGd860pTgg9A1YKLgpx3d/jL8firUF+mgEdQ= 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: The memory allocation profiling document was added to the bottom of the new outline. Apparently it was not decided by well-defined guidelines or a thorough discussions. Rather than that, it was added there just because there was no place for such unsorted documents. Now there is the chapter. Move the document to the new place. Signed-off-by: SeongJae Park --- Documentation/mm/index.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/mm/index.rst b/Documentation/mm/index.rst index 15614df2b989..0be1c7503a01 100644 --- a/Documentation/mm/index.rst +++ b/Documentation/mm/index.rst @@ -23,7 +23,6 @@ see the :doc:`admin guide <../admin-guide/mm/index>`. page_cache shmfs oom - allocation-profiling Unsorted Documentation ====================== @@ -38,6 +37,7 @@ documentation, or deleted if it has served its purpose. :maxdepth: 1 active_mm + allocation-profiling arch_pgtable_helpers balance damon/index