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: 13115972 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 5C7D9C27C76 for ; Wed, 25 Jan 2023 19:28:59 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id D70F46B0072; Wed, 25 Jan 2023 14:28:58 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id CF9AD6B0073; Wed, 25 Jan 2023 14:28:58 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id B9A0C6B0074; Wed, 25 Jan 2023 14:28:58 -0500 (EST) 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 A3D896B0072 for ; Wed, 25 Jan 2023 14:28:58 -0500 (EST) Received: from smtpin23.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay05.hostedemail.com (Postfix) with ESMTP id 7119C403F2 for ; Wed, 25 Jan 2023 19:28:58 +0000 (UTC) X-FDA: 80394309156.23.A67F3D6 Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by imf02.hostedemail.com (Postfix) with ESMTP id BA6238001D for ; Wed, 25 Jan 2023 19:28:56 +0000 (UTC) Authentication-Results: imf02.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=h4IbjAXc; spf=pass (imf02.hostedemail.com: domain of rppt@kernel.org designates 139.178.84.217 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=1674674936; 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=Da25+yknECD+Y4UBFQV4E5KdZo37gAHLUe7hN6VWRS0=; b=LSYBrz/D9XGTRy2uoy9YJYeLIr5ZXgIrP556rNCBceHTsqjiuYIwrVr2pm9YKU9jcNSkGo 4CX3FxWvaTeDUBxsIShyZSc2Q7TkusfjBXXpitiQNsAXY59W2fDCFQqih5u7Pi3Zfzy1Rc SlvBIBa9yuur/eipO5Gk7UwuCF9AaY8= ARC-Authentication-Results: i=1; imf02.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=h4IbjAXc; spf=pass (imf02.hostedemail.com: domain of rppt@kernel.org designates 139.178.84.217 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=1674674936; a=rsa-sha256; cv=none; b=7cSNouIplhUTaAJRMmRpmySZe1LV6EmWVTuGV6hvDz/7hNXk6pkQXHIN0hR8tr8VZHfzsx DUF+o6i2VlGbBsQhkRRucaCUybc2X43L90gHG8nSFpc8nbutRvkS9dxia/UVyTv3VsGtWs 8oSUrEpvRg30SrOayL7X3GPJVN284Zg= 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 AD6DE615C7; 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-Rspam-User: X-Rspamd-Server: rspam04 X-Rspamd-Queue-Id: BA6238001D X-Stat-Signature: m5jhdjiakehbxy1618ch7czew9drphkf X-HE-Tag: 1674674936-785173 X-HE-Meta: U2FsdGVkX19jHCsB87UrgfiL9FJVbOjI58+Aj7FAsZ27/9CkeLfOkEjQB6KqI1DNDGlwmVrY87qJprHcDG4hf0NnhAlcN15QlduusJAyISPUEnqtuMfgrsEWJd1FLHrP2q3VsghEaU28BKrXDDlfVQOFr3q/gPJhU/thMDP4dKk6Y+blKDp+56amjuxOAKIttOpuH23oZA5QDMlgovNUF3ChUt+yUfCuf1AUCCXqqIGXMr6yQrj5CjzIuZnAz1HG0t7PT10W8zaptuOnqD6Az1T25fferMbH8S9hyWOdxT6k5IVDuRxLrdw6SndVrZEDYXlgbhXrVbjKOm9xVEYAZogJ3gwA5pkC+0jNd16YjJuY5A/Nzl7SmatKTWejqqXnbZQPe6XJK/d+069BNnCoGwk+lgwSygWJ2qNPdpR/syf8lUnABj1pdz5jSThqVGRC6ukWS9w8EmIDgB8bRDxk+wHolC91Vjmzx/+sTaS9sSmqvRm3ePYlaPL4MLSBhc38PvjAFo56ONfAYr2fK26nJ7qszBJoqosJlfN0G81MStfMsDNwuvjJobF6Sya49evFXzMiOb9cNYFo/HIY2FmVxuQnZfXOUX5n34EENm0wBzJsEeqslN83oCbZbK3G8YoM+utJh594RclbIEbGBrMtGsnEjv4HiAhvHg2eJKKuF2Hkw8z294Xbjm3M1Uap1cJL3k95KRCSQ+vb/rPF4riBMwYfeHeVPdVxRcFtdnBCYiBGlgD6lS7YmZnTomIe2AnKLrqEwm8Fc2PF6cXTTyokI9JEZGI9gO0GqLhncxIoaAjGynX7nhxtipr81nBWa6yBDd6dzH1H5qcu6/JDwk5Qfgk2QEcrgxfK7P4yt0vyjSnkUlmT6wbjLFXcHM7OlI3xz6Tip5fZzBzRgeMPAVa/E5m60utyIuOg6tkMWrkWiBTyBZKRWHM5sggljmO5y1iwOTUEC9URwAzYkMSCKkc Ma+UOVEB nhpisIChD3SgcP11k0fMAc1Ewr8061mDfioQ7QHX/7r8Mjm83Sxk9bK4gcIf+tHGRgL43Flqutrq8ffzXHo+JZ2ETcSvk3C0LdiuTBOWVRTTcweMf5MhUQ8wSq3SFrQizwjbYFKhr/uMAaGWaIxGrt9nGjmxoeizTMkZJ/vIpLTVfFot/myI8PWlkvz8Kb9pMePEgKBbBHEyI6iWOqX3rGK8AVFrpdeDyhj8rxZ7DnqmSkQXAgS9SvkuzUXPyC1Iv/XvXDV0liPAknbmJJ5hP+hLrKOf7qGWafRwdFw+oIAJw/p3l9//OuAcNWLeIY+/dku5GZIv8/6SLIduc4LA6wA735Khn4nC9EMMb 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: 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(+)