From patchwork Sun Jan 15 18:42:11 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Mike Rapoport X-Patchwork-Id: 13102444 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 A5FB8C63797 for ; Sun, 15 Jan 2023 18:42:32 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 98AAC6B0071; Sun, 15 Jan 2023 13:42:31 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 939786B0072; Sun, 15 Jan 2023 13:42:31 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 828876B0073; Sun, 15 Jan 2023 13:42:31 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0015.hostedemail.com [216.40.44.15]) by kanga.kvack.org (Postfix) with ESMTP id 6FFB06B0071 for ; Sun, 15 Jan 2023 13:42:31 -0500 (EST) Received: from smtpin30.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay05.hostedemail.com (Postfix) with ESMTP id 187064082B for ; Sun, 15 Jan 2023 18:42:31 +0000 (UTC) X-FDA: 80357904102.30.5A1067E Received: from ams.source.kernel.org (ams.source.kernel.org [145.40.68.75]) by imf13.hostedemail.com (Postfix) with ESMTP id 958F420006 for ; Sun, 15 Jan 2023 18:42:29 +0000 (UTC) Authentication-Results: imf13.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=KgvxCLGv; spf=pass (imf13.hostedemail.com: domain of rppt@kernel.org designates 145.40.68.75 as permitted sender) smtp.mailfrom=rppt@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=1673808149; 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:references:dkim-signature; bh=bYVwCCeoIZuzJ6n9n08f+QhUA3CAlg2CUsVlH6jfWWU=; b=6KQSGSJ56Qw1aO6DQzxSg52AvC353TblZqFYmfYJ901VKt7VAZLvY2vK54jH2Fn+4WgNAw mNvpYZye9VNTb9PTlExm158MESw6/PFbStTbHNqQlLvvl7xcvCToFwpMBGkDDfKNp3QvN2 uOJC2J6a6ssqsaWVE5Lsk/Mt4HGVByI= ARC-Authentication-Results: i=1; imf13.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=KgvxCLGv; spf=pass (imf13.hostedemail.com: domain of rppt@kernel.org designates 145.40.68.75 as permitted sender) smtp.mailfrom=rppt@kernel.org; dmarc=pass (policy=none) header.from=kernel.org ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1673808149; a=rsa-sha256; cv=none; b=xR+bbjjfhMc6iHGFVp/YGTkeg823ueh1qeQYOSArmzfcZNgqAzzlCjR/in1OScNoY9RSSO a4WGkQAcCpDloaBS+C6r6sEhQ1IXTzPxzFaB/94NLtVitMqaKRX8OhDctWeab3CZ6fl2Wa jP8dO84Y1cBvqSI0LhBEVuj50IxY+wk= 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 7D5BBB80B8B; Sun, 15 Jan 2023 18:42:27 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 9587EC433EF; Sun, 15 Jan 2023 18:42:22 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1673808146; bh=z11MFNtV3X3bexpW51OoHjzIJBfJWYhzONMb5AHF4Hs=; h=From:To:Cc:Subject:Date:From; b=KgvxCLGviINKr8HSgryYWcHu97Z6S76usHSgEw43auqHfd/fmzAGQTha7oSFnwTUj oiD69dL0laJ/5SCeZ0KjLARkAnCmZvA0503c3TRoTmhdlxQSJggGgvHYC61+vhZO9V 3KHImVs6lhJo2LlgsMvpU8acSTRhhCvgoX7pkJgjbl9FyQTbqoRM6VofW8MtamencW uC3WY3RxSJBUj163OoMmZYeuHIWl7gJYS3ptzkARJi7xIW1HZY78h8fAvznV2W5LoD dFp+QR5f7FTAAj9GaQqARJhDvTiQkxwsGmzyj/HWhyXJKdalODz3L1Job/wNSD4AXq +oid1JlGlTrDQ== From: Mike Rapoport To: Jonathan Corbet Cc: Andrew Morton , Bagas Sanjaya , David Hildenbrand , Johannes Weiner , Lorenzo Stoakes , "Matthew Wilcox (Oracle)" , Mel Gorman , Michal Hocko , Mike Rapoport , Vlastimil Babka , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-mm@kvack.org Subject: [PATCH v4 0/1] docs/mm: start filling out new structure Date: Sun, 15 Jan 2023 20:42:11 +0200 Message-Id: <20230115184212.996298-1-rppt@kernel.org> X-Mailer: git-send-email 2.35.1 MIME-Version: 1.0 X-Rspamd-Server: rspam07 X-Rspamd-Queue-Id: 958F420006 X-Rspam-User: X-Stat-Signature: 5bjggji747rcxh7yqrdrbkh3u3jcoyxp X-HE-Tag: 1673808149-447076 X-HE-Meta: U2FsdGVkX19injd1ar+/txeKfZqy0OgDeaD4mljck0F/wANnFsS7DZDqSg+V3jTiOJdL72XwuLj91yprIDX8z9QMEC/NEFErLnAsZLbydvguBiaFAMB+iltM6hu+YXkVhJFILmoYpH+Y5ohfGLZkGdj8ygmqf32K/ml68IgSC1Z8/3rB4AZ3Q6vEszPJNDWFW98Zl4WrdymuGo57HruPuDrO8/3cXxWDWqtHytvQbxtXKX3ostIWiQblmMSFZ6/HuA6GTV/Q5CbDpOUjJcfX3kVY62TGs4IH7DqJ3lxLXsh2kopPp+79PqyIkKvKG+q9uWrNGV/0kOBDZ8iOxW2WtWYKrbpdh1cGIXsqfoEhtAe+o/s9eOLsJETcIReYI9CHb/xWr2JnodtQ9WMrv+vHVsCQNDbAlNSVNFYTP2zC1jbDpzKWen21a5h43XbE5vUGGaJwVnZC7AncMmYdFinXJcPSo7V7XmcG2kntu5OrRkUw5NhVx7Luub8lOmUIDjqfGOrzimgYHYGWFg4ALSCe2QoLPmH1QspG+m0RyaJAMr67zEu8zedo2UsA0IDXzE8hTW/s4httF8LNWAhFd+LMWPMZsWxFmJVvf006M5qdUBGM7O3cn/lXfqbl3gbWJ380DoXM0wESI0JLMWmgEH2o8pZyKzyygp8v1Z0vhwrSRxZQzMOYluMR+adgkxLJFJ704Rjd0JQmnvlNz4QUX4QIuZ4qXngrC9gRR5qTCUWoTrwvcmO9DSHBoFcucZksVB9WKgOZaYBvfI12j8B15F2Lexu3eUdGHksrR4Pu2z2xTDyVsz26y9vAE9NHwUNctFv6dhHA+z9oc0d+RLp6+xET6a2UjAIB0oUAjqUEYM+3BCpcXoALhfG4FjyfSncskYp3o60cPrfQRx4UWe6iXn98Vvja1Cc+/G7f3jN7ZL6jSNU2WqrJobKuWOb9pF55kFwZjZZQE1Ln9sV/HR95Wxk NxXglgsJ yKi6ecmcP2NQL0dV3hkl22eH01tTn6jZSXeBLLuFlmbD7HOfj0ln2Ojl+FtinHp2S7E7GfPg6/BUtdbE= 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: Hi, Last year at LSF/MM Matthew promptly created the new structure for MM documentation, but there still was no patches with content. I've started to work on it a while ago and I wanted to send it out in a more complete form, but I've got distracted and didn't have time to work on this. With fast changes around struct page and the threat of Lorenzo's book, I've decided to send out what I have till now with a hope that we can really make this a collaborative effort with people filling paragraph here and there. If somebody does not feel like sending formal patches, just send me the "raw" text my way and I'll deal with the rest. The text is relatively heavily formatted because I believe the target audience will prefer html version. v4: * squash commits into one (Bagas) * fix references formatting (kbuild) * add Reviewed-by and Acked-by tags v3: https://lore.kernel.org/all/20230112091616.824565-1-rppt@kernel.org * rephrase ZONE_DMA(32) and ZONE_MOVABLE description (Michal) * add cross-reference to DMA API v2: https://lore.kernel.org/all/20230110152358.2641910-1-rppt@kernel.org * rephrase the paragraph inroducing zones (Lorenzo) * update formatting (Bagas) * add section stubs (Bagas) * small fixes here and there v1: https://lore.kernel.org/all/20230101094523.1522109-1-rppt@kernel.org Mike Rapoport (IBM) (1): docs/mm: Physical Memory: add structure, introduction and nodes description Documentation/core-api/dma-api.rst | 2 + Documentation/mm/page_reclaim.rst | 2 + Documentation/mm/physical_memory.rst | 346 +++++++++++++++++++++++++++ 3 files changed, 350 insertions(+)