[PATCH -next] Documentation/vm: fix tables in arch_pgtable_helpers

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



From: Randy Dunlap <rdunlap@xxxxxxxxxxxxx>

Make the tables be presented as tables in the generated output files
(the line drawing did not present well).

Signed-off-by: Randy Dunlap <rdunlap@xxxxxxxxxxxxx>
Cc: Jonathan Corbet <corbet@xxxxxxx>
Cc: linux-doc@xxxxxxxxxxxxxxx
Cc: Anshuman Khandual <anshuman.khandual@xxxxxxx>
Cc: Mike Rapoport <rppt@xxxxxxxxxx>
Cc: linux-arch@xxxxxxxxxxxxxxx
Cc: linux-mm@xxxxxxxxx
Cc: Andrew Morton <akpm@xxxxxxxxxxxxxxxxxxxx>
---
 Documentation/vm/arch_pgtable_helpers.rst |  333 ++++++--------------
 1 file changed, 116 insertions(+), 217 deletions(-)

--- linux-next-20200707.orig/Documentation/vm/arch_pgtable_helpers.rst
+++ linux-next-20200707/Documentation/vm/arch_pgtable_helpers.rst
@@ -17,242 +17,141 @@ 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              |
---------------------------------------------------------------------------------
+===========================   ================================================
+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              |
---------------------------------------------------------------------------------
+===========================   ================================================
+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_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              |
---------------------------------------------------------------------------------
+===========================   ================================================
+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_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        |
---------------------------------------------------------------------------------
+============================   ===============================================
+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 |
---------------------------------------------------------------------------------
-| __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 |
---------------------------------------------------------------------------------
-| __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)|
---------------------------------------------------------------------------------
+==========================  =================================================
+__pte_to_swp_entry          Creates a swapped entry (arch) from a mapepd 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
+__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/




[Index of Archives]     [Linux Kernel]     [Kernel Newbies]     [x86 Platform Driver]     [Netdev]     [Linux Wireless]     [Netfilter]     [Bugtraq]     [Linux Filesystems]     [Yosemite Discussion]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Samba]     [Device Mapper]

  Powered by Linux