From mboxrd@z Thu Jan 1 00:00:00 1970 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 D5141EB64D7 for ; Fri, 16 Jun 2023 14:14:43 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 2FDD96B0074; Fri, 16 Jun 2023 10:14:43 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 2866F6B0075; Fri, 16 Jun 2023 10:14:43 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 1275C6B0078; Fri, 16 Jun 2023 10:14:43 -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 F2F536B0074 for ; Fri, 16 Jun 2023 10:14:42 -0400 (EDT) Received: from smtpin30.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay08.hostedemail.com (Postfix) with ESMTP id 8DCBF140C3B for ; Fri, 16 Jun 2023 14:14:42 +0000 (UTC) X-FDA: 80908806804.30.A1D93BE Received: from ms.lwn.net (ms.lwn.net [45.79.88.28]) by imf20.hostedemail.com (Postfix) with ESMTP id 017921C002A for ; Fri, 16 Jun 2023 14:14:38 +0000 (UTC) Authentication-Results: imf20.hostedemail.com; dkim=pass header.d=lwn.net header.s=20201203 header.b="WWo7/TV0"; dmarc=none; spf=pass (imf20.hostedemail.com: domain of corbet@lwn.net designates 45.79.88.28 as permitted sender) smtp.mailfrom=corbet@lwn.net ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1686924879; 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: in-reply-to:in-reply-to:references:references:dkim-signature; bh=GHKjBONqsI6d2ikvhbJMXfsA/8uggthZwvsqRwbZQQg=; b=GtLC+YW/6Dff3yPVWDO+Wc1J+RoDp9C/5WUn7A2t6A0pdq7FLQykyJVUSdqZduitVeDaCM o2ZryDwPbMo6MKlrrZI4/f7gy8O39ombzfEDrt4jHRAS0/0duFLHYmQGNx6o/maL++QWrk R9QGZo1OGFlz9oRLwSAsSH+AYutGLcs= ARC-Authentication-Results: i=1; imf20.hostedemail.com; dkim=pass header.d=lwn.net header.s=20201203 header.b="WWo7/TV0"; dmarc=none; spf=pass (imf20.hostedemail.com: domain of corbet@lwn.net designates 45.79.88.28 as permitted sender) smtp.mailfrom=corbet@lwn.net ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1686924879; a=rsa-sha256; cv=none; b=f6IxScc/AMAYeb6ITcxLo3DOxoP69XDKAqAAgTvKsYt56nek+5qcBBjCAMMKlWld9eflzb 3kZ6tgqI537oDs2nhyeGuObW+1RXQlGmSJxRdPUvawqDn1JDAST5u7jVRFb7hOYO2rzil1 cUI5Zlg9aQ7fmWmVjoRF7N3R5VGNGIo= Received: from localhost (unknown [IPv6:2601:281:8300:73::5f6]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ms.lwn.net (Postfix) with ESMTPSA id C0F3837A; Fri, 16 Jun 2023 14:14:36 +0000 (UTC) DKIM-Filter: OpenDKIM Filter v2.11.0 ms.lwn.net C0F3837A DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lwn.net; s=20201203; t=1686924876; bh=GHKjBONqsI6d2ikvhbJMXfsA/8uggthZwvsqRwbZQQg=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=WWo7/TV0kwWyrTS/4XPT2hs7HIGUmuOjILWtPswnq/ozgcuKO2u1pQP+DeqaS5fBf HzqI87Pqm9vYcXYGxawUXmTVOUvcTBsyUR6i+fsU4xCrIGLUaG4v1nQ7YJVhuWrk5Z mMnTy2emT6C1hGmwoJq1+1oUFIMiX15JrA7Q4tadGwUlZ3dwyaU+odID/ghhAmjmzF s/FEen4GO42tUYYnpIdrhyM935x3EAsXOmIAgkDqmh+5k0tM66KnA/86oAvMIA3lKK No8VuKdhO0SAgYD9mhgq2w+OPXlo8EoX+F5fJJLWLfFAANiEh3IHF8B+RCS37eHK8E q24sSizdHm1qw== From: Jonathan Corbet To: Linus Walleij , Andrew Morton Cc: linux-mm@kvack.org, linux-doc@vger.kernel.org, Linus Walleij , Matthew Wilcox , Randy Dunlap , Mike Rapoport , Jonathan Cameron , Bagas Sanjaya Subject: Re: [PATCH v5] Documentation/mm: Initial page table documentation In-Reply-To: <20230614072548.996940-1-linus.walleij@linaro.org> References: <20230614072548.996940-1-linus.walleij@linaro.org> Date: Fri, 16 Jun 2023 08:14:36 -0600 Message-ID: <87edmbze7n.fsf@meer.lwn.net> MIME-Version: 1.0 Content-Type: text/plain X-Rspam-User: X-Rspamd-Server: rspam12 X-Rspamd-Queue-Id: 017921C002A X-Stat-Signature: fk5obzd7eckb3b9rgj6hi97ythns786d X-HE-Tag: 1686924878-993282 X-HE-Meta: U2FsdGVkX18BfVSIQ/4XI8Z0FMW6Owk5hcJ/C9tccztZvYdelJwKsc2jvuqVLFtx+j5J3l4rfo5ZSBugrYI+x1O60GnsXqDX195E3E2zbIthZDaEKwpovm/7Nxk8QTNxDqxtgCroFtQb1q6znFU48Jtss+AAfAI4YIWNnxchIruomtGbj3RIUvuN6JxFatoV3EiNdRbqZr0EYTb3kEaSAFuheqfkIqsqKmknqXZADwN+P3Wbv7XB4sWVE993AinwYzTxHEQ7D3SS8V3C/VWaqI3Nbf89K7htDgK7LIoZXrcJ1r5svAYrVG3U6gXYCXNQlRZRZOHPCU+MNbrpoBcUi5fdRlBfloFGS2KuuM8Ox1CFaDg5ltRyGB5kZnKGyV7mzrTKHwG2ABJFlZ/C0MkKIyxe3KoI+StGE9ipBwsrBL0x+7f0WhVULXcUFOQoVBBEaXScyxnlB1uSByliC20Z91qp5dzfj5ZT1AQKX4nlve+Hz0SnFOp+frHcl+Ec5n7CkHQNFzKkwbyQs90FT9/C2WKzZSa9YOuDd/Q0z2WCEHYo3b+b2dkTezDctxsk/Hr7V0pp8F4OzChPR3KSdWQxf1Dhtb1digFsez+EUkaGHtr02z+Gy9ckfSwVXNQnleXr4cVwQKUNnxNNq0L/yoMv1VBFnWx6A0PEXgLoNklmCMEI6cA3RpIPpMrRqjDF/XFu5Jfd3//dCtZWdj7dbi/cF62h6AgRCAJcKJfihRtxctcsGL5u6KsU4Py3sxbem1ivx1GdoVB32PwWczo+XTeSzMnlpP15+M8SnUKbDE3Ec2zFBrdvFs3UAbI5xGqXBtmk+F9MamEIzY4vxq112xxJRBZhJLI7yv3Yo9AxT2n+I/KrMJnWfKkLku1qNRerSOVnNfmvacyBLqPShyni9puB0qNjs1PijPyCF7cGho/v3N0MUQpX6a8F59yu1MPU5T40ZIxIZNuan8Jo60+yah4 J4JAbe8a zFsFI0Iwx30IJbEkKDbaz8avug71+/+s6moS/Ptd/lSAY6U3M+jp8U1mnTfpunx2JGcL1Ml6UlWIdyOUBHkAkWNoVeTdcBOMyr6f8bexJ/fcbM+dYcEBkDTrNcfIVop0nHnVzbBfkdxGYBrYUjfWe6/TgfpcQZPPSvKky3y92Q4W5F8rp1cbHIwSluQEYy58OtQHwqDPmZ1lXaAqHqaKcpuPCV2LqTwDwhYQYGiwyWt+duJgQGcHiedOklp5huTe96o8L278zc3hnq4rxZ6M813yeGuEzJ4nbcU/2v+xXnRuh64sAZ1kDAOJ2f4tAlBE4g+XPHP3QCkbw2HopDzZpuWNzv+Hj5ThhD6Y7 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: Linus Walleij writes: > This is based on an earlier blog post at people.kernel.org, > it describes the concepts about page tables that were hardest > for me to grasp when dealing with them for the first time, > such as the prevalent three-letter acronyms pfn, pgd, p4d, > pud, pmd and pte. > > I don't know if this is what people want, but it's what I would > have wanted. The wording, introduction, choice of initial subjects > and choice of style is mine. > > I discussed at one point with Mike Rapoport to bring this into > the kernel documentation, so here is a small proposal. > > The current form is augmented in response to feedback from > Mike Rapoport, Matthew Wilcox, Jonathan Cameron, Kuan-Ying Lee, > Randy Dunlap and Bagas Sanjaya. > > Cc: Matthew Wilcox > Cc: Randy Dunlap > Reviewed-by: Mike Rapoport > Reviewed-by: Jonathan Cameron > Reviewed-by: Bagas Sanjaya > Link: https://people.kernel.org/linusw/arm32-page-tables > Signed-off-by: Linus Walleij So I think this has gone around enough and have decided to pick it up. If there are parts that people aren't happy with, we can surely fix them up as we go on. Meanwhile, it's good to see an effort to fill in one of the gaps here, thanks for doing it. Thanks, jon