From patchwork Wed Jan 25 19:28:40 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Mike Rapoport X-Patchwork-Id: 4524 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:adf:eb09:0:0:0:0:0 with SMTP id s9csp450273wrn; Wed, 25 Jan 2023 11:37:07 -0800 (PST) X-Google-Smtp-Source: AMrXdXtiAB2ekNvSwM6ahQzVjFWFOSo77P3sh6b3BJpfr9Lh6J/UNwdmavWxZ+HDnEjun3tkZq6d X-Received: by 2002:a17:907:1747:b0:86e:7300:1fa8 with SMTP id lf7-20020a170907174700b0086e73001fa8mr39119937ejc.35.1674675427705; Wed, 25 Jan 2023 11:37:07 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1674675427; cv=none; d=google.com; s=arc-20160816; b=qZqpFi1dyItn+6ux/iPhWT7bWPRZQIwKE25hFpSjNu/sAoM8DiC0ilkt2KH3JuVLnr +gbGZcTjEmOzuH/Gzi+EZFK9+3dKYiom0sqTyXRLZK+nCL8TFLJD4hULLd8CYEwggWqm OIWcAwwLoRKpaqzkUCh9ICu3o9RvH4KL02H7ZefRWxJJNSr6UhTGIJ7F/JlKhsBTxnyY 4CgyOCm3vjTt7/trHdCDW6sUM7WpkrBXsKkfMFUk6+NuO1PiMo3PselQqYn7kmqYRiBz 4nNQMDvdwglxZun21V4QdnUlueokxvN0btQQjHA66rDgcA/IEZQba1YtiPmt1B2nRNpm 9TSw== 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 :message-id:date:subject:cc:to:from:dkim-signature; bh=Da25+yknECD+Y4UBFQV4E5KdZo37gAHLUe7hN6VWRS0=; b=a14LsZMdJlSvrKiPCya4kJL42viA2p5j+kmINuYIjRswVjZzD6pb9SDxwyrr8fMAof ZdwpSySTUWmJXW8WyOoVKGNRYlOa8/ZhN5Bwt17+Q8jBukTQG+MN65ai15nXIXSR2YqH NOAa7WpcTL7huMJ2FxOKBiV3EgC+WGPA+xG3y3VnkrjldRJlFtFqd0KHsMN7FpKmhRxU mBdbkEmz6Su3MrxggdscnY/iiASs/8Q27+zHJiXwcy+DUk2rs1wtfbc4E9BbUXNFLRx0 NbOZvTfl4JkmDrnwwEvtzwVjdspckCEA+Ze01bIsUwezTt4yK4ktqVcL3Ptx8gkPvI8p aYrg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=h4IbjAXc; 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 wl21-20020a170907311500b007c170f6b32esi5487364ejb.527.2023.01.25.11.36.40; Wed, 25 Jan 2023 11:37:07 -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=h4IbjAXc; 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 S234966AbjAYT3C (ORCPT + 99 others); Wed, 25 Jan 2023 14:29:02 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:41882 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229449AbjAYT3B (ORCPT ); Wed, 25 Jan 2023 14:29:01 -0500 Received: from dfw.source.kernel.org (dfw.source.kernel.org [IPv6:2604:1380:4641:c500::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 3579116ACF; Wed, 25 Jan 2023 11:28:56 -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 dfw.source.kernel.org (Postfix) with ESMTPS id AFB01615CC; Wed, 25 Jan 2023 19:28:55 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 63D90C433D2; Wed, 25 Jan 2023 19:28:51 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1674674935; bh=6X73NX5j0pdKQCjWu91w+LH3cNHmhTzci/Tjxm01REM=; h=From:To:Cc:Subject:Date:From; b=h4IbjAXcQ07Ul7kUysKKrLB0Kxw2pdwQkCaWH1crC0sedx4zxq3OoFUKwb1B2Wc2+ rCAxszh7hp/QXGXrnbo2u+LPTDkWOQYSyN7WozhN4sgabiGhVDvWcWMTcWPy4L9N9v Jut/5DBukorM5pygJGEUd7IjJ235CPQnCq1UBm2q/73/n6V/koO2ppmOofTUpb7ccr Com1WR94iqb+QeEqBdKv8jgiOGJEkQ+ZOOfD3DWb+sl+doC2VLtS8EBeIob2shzQin c6GdZB0dULFNVcObs13TQAntv/2dXeWLm0JfhhHHtnncWDX4P2FJ3IeBKGhKVqfq9w qYuArwzATRSVA== 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 v5 0/1] docs/mm: start filling out new structure Date: Wed, 25 Jan 2023 21:28:40 +0200 Message-Id: <20230125192841.25342-1-rppt@kernel.org> X-Mailer: git-send-email 2.35.1 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?1756024461270884332?= X-GMAIL-MSGID: =?utf-8?q?1756024461270884332?= From: "Mike Rapoport (IBM)" 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. v5: * fix node_states[] example (Vlastimil) v4: https://lore.kernel.org/all/20230115184212.996298-1-rppt@kernel.org * 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(+)