Documentation/mm: Initial page table documentation
authorLinus Walleij <linus.walleij@linaro.org>
Wed, 14 Jun 2023 07:25:48 +0000 (09:25 +0200)
committerJonathan Corbet <corbet@lwn.net>
Fri, 16 Jun 2023 14:13:13 +0000 (08:13 -0600)
commite72ef2d2ba39bad77f37536817124ae52c90e7cf
tree8edf2fe1d91a33980b3a4c2d1822b6785b505f3c
parentd27e40b5548182df4095c801020f239f103e4307
Documentation/mm: Initial page table documentation

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 <willy@infradead.org>
Reviewed-by: Mike Rapoport <rppt@kernel.org>
Reviewed-by: Jonathan Cameron <Jonathan.Cameron@huawei.com>
Link: https://people.kernel.org/linusw/arm32-page-tables
Signed-off-by: Linus Walleij <linus.walleij@linaro.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Link: https://lore.kernel.org/r/20230614072548.996940-1-linus.walleij@linaro.org
Documentation/mm/page_tables.rst