[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]
Message-ID: <bde227ef-b072-4f48-ab68-bf184dfe7421@linux.dev>
Date: Mon, 22 Dec 2025 11:20:48 +0800
From: Muchun Song <muchun.song@...ux.dev>
To: Kiryl Shutsemau <kas@...nel.org>
Cc: Oscar Salvador <osalvador@...e.de>, Mike Rapoport <rppt@...nel.org>,
Vlastimil Babka <vbabka@...e.cz>,
Lorenzo Stoakes <lorenzo.stoakes@...cle.com>, Zi Yan <ziy@...dia.com>,
Baoquan He <bhe@...hat.com>, Michal Hocko <mhocko@...e.com>,
Johannes Weiner <hannes@...xchg.org>, Jonathan Corbet <corbet@....net>,
kernel-team@...a.com, linux-mm@...ck.org, linux-kernel@...r.kernel.org,
linux-doc@...r.kernel.org, Andrew Morton <akpm@...ux-foundation.org>,
David Hildenbrand <david@...nel.org>, Matthew Wilcox <willy@...radead.org>,
Usama Arif <usamaarif642@...il.com>, Frank van der Linden <fvdl@...gle.com>
Subject: Re: [PATCHv2 06/14] mm: Rework compound_head() for power-of-2
sizeof(struct page)
On 2025/12/18 23:09, Kiryl Shutsemau wrote:
> For tail pages, the kernel uses the 'compound_info' field to get to the
> head page. The bit 0 of the field indicates whether the page is a
> tail page, and if set, the remaining bits represent a pointer to the
> head page.
>
> For cases when size of struct page is power-of-2, change the encoding of
> compound_info to store a mask that can be applied to the virtual address
> of the tail page in order to access the head page. It is possible
> because struct page of the head page is naturally aligned with regards
> to order of the page.
>
> The significant impact of this modification is that all tail pages of
> the same order will now have identical 'compound_info', regardless of
> the compound page they are associated with. This paves the way for
> eliminating fake heads.
>
> The HugeTLB Vmemmap Optimization (HVO) creates fake heads and it is only
> applied when the sizeof(struct page) is power-of-2. Having identical
> tail pages allows the same page to be mapped into the vmemmap of all
> pages, maintaining memory savings without fake heads.
>
> If sizeof(struct page) is not power-of-2, there is no functional
> changes.
>
> Signed-off-by: Kiryl Shutsemau <kas@...nel.org>
Reviewed-by: Muchun Song <muchun.song@...ux.dev>
One nit bellow.
> ---
> include/linux/page-flags.h | 62 +++++++++++++++++++++++++++++++++-----
> mm/util.c | 16 +++++++---
> 2 files changed, 66 insertions(+), 12 deletions(-)
>
> diff --git a/include/linux/page-flags.h b/include/linux/page-flags.h
> index 0de7db7efb00..fac5f41b3b27 100644
> --- a/include/linux/page-flags.h
> +++ b/include/linux/page-flags.h
> @@ -210,6 +210,13 @@ static __always_inline const struct page *page_fixed_fake_head(const struct page
> if (!static_branch_unlikely(&hugetlb_optimize_vmemmap_key))
> return page;
>
> + /*
> + * Fake heads only exists if size of struct page is power-of-2.
> + * See hugetlb_vmemmap_optimizable_size().
> + */
> + if (!is_power_of_2(sizeof(struct page)))
> + return page;
> +
> /*
> * Only addresses aligned with PAGE_SIZE of struct page may be fake head
> * struct page. The alignment check aims to avoid access the fields (
> @@ -223,10 +230,14 @@ static __always_inline const struct page *page_fixed_fake_head(const struct page
> * because the @page is a compound page composed with at least
> * two contiguous pages.
> */
> - unsigned long head = READ_ONCE(page[1].compound_info);
> + unsigned long info = READ_ONCE(page[1].compound_info);
>
> - if (likely(head & 1))
> - return (const struct page *)(head - 1);
> + /* See set_compound_head() */
> + if (likely(info & 1)) {
> + unsigned long p = (unsigned long)page;
> +
> + return (const struct page *)(p & info);
> + }
> }
> return page;
> }
> @@ -281,11 +292,27 @@ static __always_inline int page_is_fake_head(const struct page *page)
>
> static __always_inline unsigned long _compound_head(const struct page *page)
> {
> - unsigned long head = READ_ONCE(page->compound_info);
> + unsigned long info = READ_ONCE(page->compound_info);
>
> - if (unlikely(head & 1))
> - return head - 1;
> - return (unsigned long)page_fixed_fake_head(page);
> + /* Bit 0 encodes PageTail() */
> + if (!(info & 1))
> + return (unsigned long)page_fixed_fake_head(page);
> +
> + /*
> + * If the size of struct page is not power-of-2, the rest of
> + * compound_info is the pointer to the head page.
> + */
> + if (!is_power_of_2(sizeof(struct page)))
> + return info - 1;
> +
> + /*
> + * If the size of struct page is power-of-2 the rest of the info
> + * encodes the mask that converts the address of the tail page to
> + * the head page.
> + *
> + * No need to clear bit 0 in the mask as 'page' always has it clear.
> + */
> + return (unsigned long)page & info;
> }
>
> #define compound_head(page) ((typeof(page))_compound_head(page))
> @@ -294,7 +321,26 @@ static __always_inline void set_compound_head(struct page *page,
> const struct page *head,
> unsigned int order)
> {
> - WRITE_ONCE(page->compound_info, (unsigned long)head + 1);
> + unsigned int shift;
> + unsigned long mask;
> +
> + if (!is_power_of_2(sizeof(struct page))) {
> + WRITE_ONCE(page->compound_info, (unsigned long)head | 1);
> + return;
> + }
> +
> + /*
> + * If the size of struct page is power-of-2, bits [shift:0] of the
> + * virtual address of compound head are zero.
> + *
> + * Calculate mask that can be applied to the virtual address of
> + * the tail page to get address of the head page.
> + */
> + shift = order + order_base_2(sizeof(struct page));
We already have a macro for order_base_2(sizeof(struct page)),
that is STRUCT_PAGE_MAX_SHIFT.
Thanks.
> + mask = GENMASK(BITS_PER_LONG - 1, shift);
> +
> + /* Bit 0 encodes PageTail() */
> + WRITE_ONCE(page->compound_info, mask | 1);
> }
>
> static __always_inline void clear_compound_head(struct page *page)
> diff --git a/mm/util.c b/mm/util.c
> index cbf93cf3223a..3c00f6cec3f0 100644
> --- a/mm/util.c
> +++ b/mm/util.c
> @@ -1234,7 +1234,7 @@ static void set_ps_flags(struct page_snapshot *ps, const struct folio *folio,
> */
> void snapshot_page(struct page_snapshot *ps, const struct page *page)
> {
> - unsigned long head, nr_pages = 1;
> + unsigned long info, nr_pages = 1;
> struct folio *foliop;
> int loops = 5;
>
> @@ -1244,8 +1244,8 @@ void snapshot_page(struct page_snapshot *ps, const struct page *page)
> again:
> memset(&ps->folio_snapshot, 0, sizeof(struct folio));
> memcpy(&ps->page_snapshot, page, sizeof(*page));
> - head = ps->page_snapshot.compound_info;
> - if ((head & 1) == 0) {
> + info = ps->page_snapshot.compound_info;
> + if ((info & 1) == 0) {
> ps->idx = 0;
> foliop = (struct folio *)&ps->page_snapshot;
> if (!folio_test_large(foliop)) {
> @@ -1256,7 +1256,15 @@ void snapshot_page(struct page_snapshot *ps, const struct page *page)
> }
> foliop = (struct folio *)page;
> } else {
> - foliop = (struct folio *)(head - 1);
> + /* See compound_head() */
> + if (is_power_of_2(sizeof(struct page))) {
> + unsigned long p = (unsigned long)page;
> +
> + foliop = (struct folio *)(p & info);
> + } else {
> + foliop = (struct folio *)(info - 1);
> + }
> +
> ps->idx = folio_page_idx(foliop, page);
> }
>
Powered by blists - more mailing lists