The patch titled
Subject: documentation-mm-add-descriptions-for-arch-page-table-helpers-v5
has been added to the -mm tree. Its filename is
documentation-mm-add-descriptions-for-arch-page-table-helpers-v5.patch
This patch should soon appear at
http://ozlabs.org/~akpm/mmots/broken-out/documentation-mm-add-descriptions-for-arch-page-table-helpers-v5.patch
and later at
http://ozlabs.org/~akpm/mmotm/broken-out/documentation-mm-add-descriptions-for-arch-page-table-helpers-v5.patch
Before you just go and hit "reply", please:
a) Consider who else should be cc'ed
b) Prefer to cc a suitable mailing list as well
c) Ideally: find the original patch on the mailing list and do a
reply-to-all to that, adding suitable additional cc's
*** Remember to use Documentation/process/submit-checklist.rst when testing your code ***
The -mm tree is included into linux-next and is updated
there every 3-4 working days
------------------------------------------------------
From: Anshuman Khandual <anshuman.khandual@xxxxxxx>
Subject: documentation-mm-add-descriptions-for-arch-page-table-helpers-v5
fold in Mike's patch for the rst document, fix typos in the rst document
Link: http://lkml.kernel.org/r/1594610587-4172-5-git-send-email-anshuman.khandual@xxxxxxx
Signed-off-by: Anshuman Khandual <anshuman.khandual@xxxxxxx>
Suggested-by: Mike Rapoport <rppt@xxxxxxxxxx>
Acked-by: Mike Rapoport <rppt@xxxxxxxxxxxxx>
Cc: Benjamin Herrenschmidt <benh@xxxxxxxxxxxxxxxxxxx>
Cc: Borislav Petkov <bp@xxxxxxxxx>
Cc: Catalin Marinas <catalin.marinas@xxxxxxx>
Cc: Christian Borntraeger <borntraeger@xxxxxxxxxx>
Cc: Heiko Carstens <heiko.carstens@xxxxxxxxxx>
Cc: "H. Peter Anvin" <hpa@xxxxxxxxx>
Cc: Ingo Molnar <mingo@xxxxxxxxxx>
Cc: Jonathan Corbet <corbet@xxxxxxx>
Cc: Kirill A. Shutemov <kirill@xxxxxxxxxxxxx>
Cc: Michael Ellerman <mpe@xxxxxxxxxxxxxx>
Cc: Palmer Dabbelt <palmer@xxxxxxxxxxx>
Cc: Paul Mackerras <paulus@xxxxxxxxx>
Cc: Paul Walmsley <paul.walmsley@xxxxxxxxxx>
Cc: Thomas Gleixner <tglx@xxxxxxxxxxxxx>
Cc: Vasily Gorbik <gor@xxxxxxxxxxxxx>
Cc: Vineet Gupta <vgupta@xxxxxxxxxxxx>
Cc: Will Deacon <will@xxxxxxxxxx>
Cc: Zi Yan <ziy@xxxxxxxxxx>
Signed-off-by: Andrew Morton <akpm@xxxxxxxxxxxxxxxxxxxx>
---
Documentation/vm/arch_pgtable_helpers.rst | 232 ++++++++++----------
1 file changed, 116 insertions(+), 116 deletions(-)
--- a/Documentation/vm/arch_pgtable_helpers.rst~documentation-mm-add-descriptions-for-arch-page-table-helpers-v5
+++ a/Documentation/vm/arch_pgtable_helpers.rst
@@ -17,242 +17,242 @@ test need to be in sync.
PTE Page Table Helpers
======================
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pte_same | Tests whether both PTE entries are the same |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pte_bad | Tests a non-table mapped PTE |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pte_present | Tests a valid mapped PTE |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pte_young | Tests a young PTE |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pte_dirty | Tests a dirty PTE |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pte_write | Tests a writable PTE |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pte_special | Tests a special PTE |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pte_protnone | Tests a PROT_NONE PTE |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pte_devmap | Tests a ZONE_DEVICE mapped PTE |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pte_soft_dirty | Tests a soft dirty PTE |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pte_swp_soft_dirty | Tests a soft dirty swapped PTE |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pte_mkyoung | Creates a young PTE |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pte_mkold | Creates an old PTE |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pte_mkdirty | Creates a dirty PTE |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pte_mkclean | Creates a clean PTE |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pte_mkwrite | Creates a writable PTE |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pte_mkwrprotect | Creates a write protected PTE |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pte_mkspecial | Creates a special PTE |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pte_mkdevmap | Creates a ZONE_DEVICE mapped PTE |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pte_mksoft_dirty | Creates a soft dirty PTE |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pte_clear_soft_dirty | Clears a soft dirty PTE |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pte_swp_mksoft_dirty | Creates a soft dirty swapped PTE |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pte_swp_clear_soft_dirty | Clears a soft dirty swapped PTE |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pte_mknotpresent | Invalidates a mapped PTE |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| ptep_get_and_clear | Clears a PTE |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| ptep_get_and_clear_full | Clears a PTE |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| ptep_test_and_clear_young | Clears young from a PTE |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| ptep_set_wrprotect | Converts into a write protected PTE |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| ptep_set_access_flags | Converts into a more permissive PTE |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
======================
PMD Page Table Helpers
======================
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pmd_same | Tests whether both PMD entries are the same |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pmd_bad | Tests a non-table mapped PMD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pmd_leaf | Tests a leaf mapped PMD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pmd_huge | Tests a HugeTLB mapped PMD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pmd_trans_huge | Tests a Transparent Huge Page (THP) at PMD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pmd_present | Tests a valid mapped PMD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pmd_young | Tests a young PMD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pmd_dirty | Tests a dirty PMD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pmd_write | Tests a writable PMD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pmd_special | Tests a special PMD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pmd_protnone | Tests a PROT_NONE PMD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pmd_devmap | Tests a ZONE_DEVICE mapped PMD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pmd_soft_dirty | Tests a soft dirty PMD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pmd_swp_soft_dirty | Tests a soft dirty swapped PMD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pmd_mkyoung | Creates a young PMD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pmd_mkold | Creates an old PMD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pmd_mkdirty | Creates a dirty PMD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pmd_mkclean | Creates a clean PMD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pmd_mkwrite | Creates a writable PMD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pmd_mkwrprotect | Creates a write protected PMD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pmd_mkspecial | Creates a special PMD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pmd_mkdevmap | Creates a ZONE_DEVICE mapped PMD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pmd_mksoft_dirty | Creates a soft dirty PMD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pmd_clear_soft_dirty | Clears a soft dirty PMD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pmd_swp_mksoft_dirty | Creates a soft dirty swapped PMD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pmd_swp_clear_soft_dirty | Clears a soft dirty swapped PMD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pmd_mkinvalid | Invalidates a mapped PMD [1] |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pmd_set_huge | Creates a PMD huge mapping |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pmd_clear_huge | Clears a PMD huge mapping |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pmdp_get_and_clear | Clears a PMD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pmdp_get_and_clear_full | Clears a PMD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pmdp_test_and_clear_young | Clears young from a PMD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pmdp_set_wrprotect | Converts into a write protected PMD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pmdp_set_access_flags | Converts into a more permissive PMD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
======================
PUD Page Table Helpers
======================
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pud_same | Tests whether both PUD entries are the same |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pud_bad | Tests a non-table mapped PUD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pud_leaf | Tests a leaf mapped PUD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pud_huge | Tests a HugeTLB mapped PUD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pud_trans_huge | Tests a Transparent Huge Page (THP) at PUD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pud_present | Tests a valid mapped PUD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pud_young | Tests a young PUD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pud_dirty | Tests a dirty PUD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pud_write | Tests a writable PUD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pud_devmap | Tests a ZONE_DEVICE mapped PUD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pud_mkyoung | Creates a young PUD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pud_mkold | Creates an old PUD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pud_mkdirty | Creates a dirty PUD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pud_mkclean | Creates a clean PUD |
---------------------------------------------------------------------------------
-| pud_mkwrite | Creates a writable PMD |
---------------------------------------------------------------------------------
-| pud_mkwrprotect | Creates a write protected PMD |
---------------------------------------------------------------------------------
-| pud_mkdevmap | Creates a ZONE_DEVICE mapped PMD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
+| pud_mkwrite | Creates a writable PUD |
++---------------------------+--------------------------------------------------+
+| pud_mkwrprotect | Creates a write protected PUD |
++---------------------------+--------------------------------------------------+
+| pud_mkdevmap | Creates a ZONE_DEVICE mapped PUD |
++---------------------------+--------------------------------------------------+
| pud_mkinvalid | Invalidates a mapped PUD [1] |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pud_set_huge | Creates a PUD huge mapping |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pud_clear_huge | Clears a PUD huge mapping |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pudp_get_and_clear | Clears a PUD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pudp_get_and_clear_full | Clears a PUD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pudp_test_and_clear_young | Clears young from a PUD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pudp_set_wrprotect | Converts into a write protected PUD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pudp_set_access_flags | Converts into a more permissive PUD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
==========================
HugeTLB Page Table Helpers
==========================
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pte_huge | Tests a HugeTLB |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| pte_mkhuge | Creates a HugeTLB |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| huge_pte_dirty | Tests a dirty HugeTLB |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| huge_pte_write | Tests a writable HugeTLB |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| huge_pte_mkdirty | Creates a dirty HugeTLB |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| huge_pte_mkwrite | Creates a writable HugeTLB |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| huge_pte_mkwrprotect | Creates a write protected HugeTLB |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| huge_ptep_get_and_clear | Clears a HugeTLB |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| huge_ptep_set_wrprotect | Converts into a write protected HugeTLB |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| huge_ptep_set_access_flags | Converts into a more permissive HugeTLB |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
========================
SWAP Page Table Helpers
========================
---------------------------------------------------------------------------------
-| __pte_to_swp_entry | Creates a swapped entry (arch) from a mapepd PTE |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
+| __pte_to_swp_entry | Creates a swapped entry (arch) from a mapped PTE |
++---------------------------+--------------------------------------------------+
| __swp_to_pte_entry | Creates a mapped PTE from a swapped entry (arch) |
---------------------------------------------------------------------------------
-| __pmd_to_swp_entry | Creates a swapped entry (arch) from a mapepd PMD |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
+| __pmd_to_swp_entry | Creates a swapped entry (arch) from a mapped PMD |
++---------------------------+--------------------------------------------------+
| __swp_to_pmd_entry | Creates a mapped PMD from a swapped entry (arch) |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| is_migration_entry | Tests a migration (read or write) swapped entry |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| is_write_migration_entry | Tests a write migration swapped entry |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| make_migration_entry_read | Converts into read migration swapped entry |
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
| make_migration_entry | Creates a migration swapped entry (read or write)|
---------------------------------------------------------------------------------
++---------------------------+--------------------------------------------------+
[1] https://lore.kernel.org/linux-mm/20181017020930.GN30832@xxxxxxxxxx/
_
Patches currently in -mm which might be from anshuman.khandual@xxxxxxx are
mm-debug_vm_pgtable-add-tests-validating-arch-helpers-for-core-mm-features.patch
mm-debug_vm_pgtable-add-tests-validating-advanced-arch-page-table-helpers.patch
mm-debug_vm_pgtable-add-tests-validating-advanced-arch-page-table-helpers-v5.patch
mm-debug_vm_pgtable-add-debug-prints-for-individual-tests.patch
documentation-mm-add-descriptions-for-arch-page-table-helpers.patch
documentation-mm-add-descriptions-for-arch-page-table-helpers-v5.patch
mm-vmstat-add-events-for-thp-migration-without-split.patch
