Skip to content

mm: replace follow_page() by folio_walk

David Hildenbrand kvm linux-doc linux-fsdevel linux-mm linux-s390 lkml 1 version In review

Get series with b4
b4 am [email protected]

Versions newest first

  1. v1 Latest11 patches 20 repliesIn review 9 of 11 applied

Patches in v1 9 of 11 applied

#Subject and filesSizeRepliesApplied
1/11mm: provide vm_normal_(page|folio)_pmd() with CONFIG_PGTABLE_HAS_HUGE_LEAVESmm/memory.c+1 -10 replies
2/11mm/pagewalk: introduce folio_walk_start() + folio_walk_end()include/linux/pagewalk.h mm/pagewalk.c+260 -02 repliesApplied
3/11mm/migrate: convert do_pages_stat_array() from follow_page() to folio_walkmm/migrate.c+15 -160 repliesApplied
4/11mm/migrate: convert add_page_for_migration() from follow_page() to folio_walkmm/migrate.c+45 -550 repliesApplied
5/11mm/ksm: convert get_mergeable_page() from follow_page() to folio_walkmm/ksm.c+14 -120 repliesApplied
6/11mm/ksm: convert scan_get_next_rmap_item() from follow_page() to folio_walkmm/ksm.c+24 -140 repliesApplied
7/11mm/huge_memory: convert split_huge_pages_pid() from follow_page() to folio_walkmm/huge_memory.c+11 -712 replies
8/11s390/uv: convert gmap_destroy_page() from follow_page() to folio_walkarch/s390/kernel/uv.c+12 -61 replyApplied
9/11s390/mm/fault: convert do_secure_storage_access() from follow_page() to folio_walkarch/s390/mm/fault.c+10 -61 replyApplied
10/11mm: remove follow_page()Documentation/mm/transhuge.rst include/linux/mm.h mm/filemap.c +2 more+5 -360 repliesApplied
11/11mm/ksm: convert break_ksm() from walk_page_range_vma() to folio_walkmm/ksm.c+16 -470 repliesApplied

Reviews trailers per patch

3 of 11 patches have a Reviewed-by or Acked-by.

PatchClaudio ImbrendaZi Yan
1/11
2/11
3/11
4/11
5/11
6/11
7/11R-b
8/11R-b
9/11R-b
10/11
11/11

Trailers given in replies are filled; those carried in the patches from earlier versions are outlined with dashes.

Read the v1 thread

Cover letter [PATCH v1 00/11] mm: replace follow_page() by folio_walk

Looking into a way of moving the last folio_likely_mapped_shared() call in add_folio_for_migration() under the PTL, I found myself removing follow_page(). This paves the way for cleaning up all the FOLL_, follow_* terminology to just be called "GUP" nowadays.

The new page table walker will lookup a mapped folio and return to the caller with the PTL held, such that the folio cannot get unmapped concurrently. Callers can then conditionally decide whether they really want to take a short-term folio reference or whether the can simply unlock the PTL and be done with it.

folio_walk is similar to page_vma_mapped_walk(), except that we don't know the folio we want to walk to and that we are only walking to exactly one PTE/PMD/PUD.

folio_walk provides access to the pte/pmd/pud (and the referenced folio page because things like KSM need that), however, as part of this series no page table modifications are performed by users.

We might be able to convert some other walk_page_range() users that really only walk to one address, such as DAMON with damon_mkold_ops/damon_young_ops. It might make sense to extend folio_walk in the future to optionally fault in a folio (if applicable), such that we can replace some get_user_pages() users that really only want to lookup a single page/folio under PTL without unconditionally grabbing a folio reference.

I have plans to extend the approach to a range walker that will try batching various page table entries (not just folio pages) to be a better replace for walk_page_range() -- and users will be able to opt in which type of page table entries they want to process -- but that will require more work and more thoughts.

KSM seems to work just fine (ksm_functional_tests selftests) and move_pages seems to work (migration selftest). I tested the leaf implementation excessively using various hugetlb sizes (64K, 2M, 32M, 1G) on arm64 using move_pages and did some more testing on x86-64. Cross compiled on a bunch of architectures.

I am not able to test the s390x Secure Execution changes, unfortunately.

Cc Andrew Morton <[email protected]>
Cc "Matthew Wilcox (Oracle)" <[email protected]>
Cc Jonathan Corbet <[email protected]>
Cc Christian Borntraeger <[email protected]>
Cc Janosch Frank <[email protected]>
Cc Claudio Imbrenda <[email protected]>
Cc Heiko Carstens <[email protected]>
Cc Vasily Gorbik <[email protected]>
Cc Alexander Gordeev <[email protected]>
Cc Sven Schnelle <[email protected]>
Cc Gerald Schaefer <[email protected]>

David Hildenbrand (11):
mm: provide vm_normal_(page|folio)_pmd() with
CONFIG_PGTABLE_HAS_HUGE_LEAVES
mm/pagewalk: introduce folio_walk_start() + folio_walk_end() mm/migrate: convert do_pages_stat_array() from follow_page() to
folio_walk
mm/migrate: convert add_page_for_migration() from follow_page() to
folio_walk
mm/ksm: convert get_mergeable_page() from follow_page() to folio_walk mm/ksm: convert scan_get_next_rmap_item() from follow_page() to
folio_walk
mm/huge_memory: convert split_huge_pages_pid() from follow_page() to
folio_walk
s390/uv: convert gmap_destroy_page() from follow_page() to folio_walk s390/mm/fault: convert do_secure_storage_access() from follow_page()
to folio_walk
mm: remove follow_page()
mm/ksm: convert break_ksm() from walk_page_range_vma() to folio_walk

 Documentation/mm/transhuge.rst |   6 +-
 arch/s390/kernel/uv.c          |  18 ++-
 arch/s390/mm/fault.c           |  16 ++-
 include/linux/mm.h             |   3 -
 include/linux/pagewalk.h       |  58 ++++++++++
 mm/filemap.c                   |   2 +-
 mm/gup.c                       |  24 +---
 mm/huge_memory.c               |  18 +--
 mm/ksm.c                       | 127 +++++++++------------
 mm/memory.c                    |   2 +-
 mm/migrate.c                   | 131 ++++++++++-----------
 mm/nommu.c                     |   6 -
 mm/pagewalk.c                  | 202 +++++++++++++++++++++++++++++++++
 13 files changed, 413 insertions(+), 200 deletions(-)
Signature · 1 line
2.45.2