* [PATCH] Docs/mm: fix stale split page table lock references
@ 2026-11-19 7:48 zhaozhengzhuo
2026-11-19 9:33 ` Lorenzo Stoakes (ARM)
0 siblings, 1 reply; 2+ messages in thread
From: zhaozhengzhuo @ 2026-11-19 7:48 UTC (permalink / raw)
To: linux-mm, linux-doc
Cc: linux-kernel, zhaozhengzhuo, Andrew Morton, Suren Baghdasaryan,
Liam R. Howlett, Lorenzo Stoakes, Vlastimil Babka, Shakeel Butt,
David Hildenbrand, Mike Rapoport, Michal Hocko, Jonathan Corbet,
Shuah Khan, Randy Dunlap, Russell King (Oracle),
Qi Zheng
The USE_SPLIT_PTE_PTLOCKS and USE_SPLIT_PMD_PTLOCKS macros were turned
into Kconfig options, and CONFIG_SPLIT_PTLOCK_CPUS was replaced, but two
Documentation/mm files still refer to the old names.
Update both references.
Fixes: 394290cba966 ("mm: turn USE_SPLIT_PTE_PTLOCKS / USE_SPLIT_PTE_PTLOCKS into Kconfig options")
Signed-off-by: zhaozhengzhuo <zhaozhengzhuo@uniontech.com>
---
Documentation/mm/process_addrs.rst | 2 +-
Documentation/mm/split_page_table_lock.rst | 8 +++++---
2 files changed, 6 insertions(+), 4 deletions(-)
diff --git a/Documentation/mm/process_addrs.rst b/Documentation/mm/process_addrs.rst
index 04b649818cc1..0b6355e6d1d5 100644
--- a/Documentation/mm/process_addrs.rst
+++ b/Documentation/mm/process_addrs.rst
@@ -659,7 +659,7 @@ acquired in :c:func:`!__p4d_alloc`, :c:func:`!__pud_alloc` and
references the :c:member:`!mm->page_table_lock`.
Allocating a PTE will either use the :c:member:`!mm->page_table_lock` or, if
-:c:macro:`!USE_SPLIT_PMD_PTLOCKS` is defined, a lock embedded in the PMD
+:c:macro:`!CONFIG_SPLIT_PMD_PTLOCKS` is enabled, a lock embedded in the PMD
physical page metadata in the form of a :c:struct:`!struct ptdesc`, acquired by
:c:func:`!pmd_ptdesc` called from :c:func:`!pmd_lock` and ultimately
:c:func:`!__pte_alloc`.
diff --git a/Documentation/mm/split_page_table_lock.rst b/Documentation/mm/split_page_table_lock.rst
index cc3cd46abd1b..ce7908bebce9 100644
--- a/Documentation/mm/split_page_table_lock.rst
+++ b/Documentation/mm/split_page_table_lock.rst
@@ -37,9 +37,11 @@ There are helpers to lock/unlock a table and other accessor functions:
- pmd_lockptr()
returns pointer to PMD table lock;
-Split page table lock for PTE tables is enabled compile-time if
-CONFIG_SPLIT_PTLOCK_CPUS (usually 4) is less or equal to NR_CPUS.
-If split lock is disabled, all tables are guarded by mm->page_table_lock.
+Split page table lock for PTE tables is enabled at compile time when
+CONFIG_SPLIT_PTE_PTLOCKS is enabled. This option requires CONFIG_MMU and
+CONFIG_SMP, with CONFIG_NR_CPUS set to at least 4 (see mm/Kconfig for
+architecture-specific restrictions). If split lock is disabled, all
+tables are guarded by mm->page_table_lock.
Split page table lock for PMD tables is enabled, if it's enabled for PTE
tables and the architecture supports it (see below).
--
2.50.1
^ permalink raw reply [flat|nested] 2+ messages in thread
* Re: [PATCH] Docs/mm: fix stale split page table lock references
2026-11-19 7:48 [PATCH] Docs/mm: fix stale split page table lock references zhaozhengzhuo
@ 2026-11-19 9:33 ` Lorenzo Stoakes (ARM)
0 siblings, 0 replies; 2+ messages in thread
From: Lorenzo Stoakes (ARM) @ 2026-11-19 9:33 UTC (permalink / raw)
To: zhaozhengzhuo
Cc: linux-mm, linux-doc, linux-kernel, Andrew Morton,
Suren Baghdasaryan, Liam R. Howlett, Vlastimil Babka,
Shakeel Butt, David Hildenbrand, Mike Rapoport, Michal Hocko,
Jonathan Corbet, Shuah Khan, Randy Dunlap, Russell King (Oracle),
Qi Zheng
On Thu, Nov 19, 2026 at 03:48:53PM +0800, zhaozhengzhuo wrote:
> The USE_SPLIT_PTE_PTLOCKS and USE_SPLIT_PMD_PTLOCKS macros were turned
> into Kconfig options, and CONFIG_SPLIT_PTLOCK_CPUS was replaced, but two
> Documentation/mm files still refer to the old names.
>
> Update both references.
>
> Fixes: 394290cba966 ("mm: turn USE_SPLIT_PTE_PTLOCKS / USE_SPLIT_PTE_PTLOCKS into Kconfig options")
> Signed-off-by: zhaozhengzhuo <zhaozhengzhuo@uniontech.com>
Seems reasonable, so:
Reviewed-by: Lorenzo Stoakes (ARM) <ljs@kernel.org>
> ---
> Documentation/mm/process_addrs.rst | 2 +-
> Documentation/mm/split_page_table_lock.rst | 8 +++++---
> 2 files changed, 6 insertions(+), 4 deletions(-)
>
> diff --git a/Documentation/mm/process_addrs.rst b/Documentation/mm/process_addrs.rst
> index 04b649818cc1..0b6355e6d1d5 100644
> --- a/Documentation/mm/process_addrs.rst
> +++ b/Documentation/mm/process_addrs.rst
> @@ -659,7 +659,7 @@ acquired in :c:func:`!__p4d_alloc`, :c:func:`!__pud_alloc` and
> references the :c:member:`!mm->page_table_lock`.
>
> Allocating a PTE will either use the :c:member:`!mm->page_table_lock` or, if
> -:c:macro:`!USE_SPLIT_PMD_PTLOCKS` is defined, a lock embedded in the PMD
> +:c:macro:`!CONFIG_SPLIT_PMD_PTLOCKS` is enabled, a lock embedded in the PMD
> physical page metadata in the form of a :c:struct:`!struct ptdesc`, acquired by
> :c:func:`!pmd_ptdesc` called from :c:func:`!pmd_lock` and ultimately
> :c:func:`!__pte_alloc`.
> diff --git a/Documentation/mm/split_page_table_lock.rst b/Documentation/mm/split_page_table_lock.rst
> index cc3cd46abd1b..ce7908bebce9 100644
> --- a/Documentation/mm/split_page_table_lock.rst
> +++ b/Documentation/mm/split_page_table_lock.rst
> @@ -37,9 +37,11 @@ There are helpers to lock/unlock a table and other accessor functions:
> - pmd_lockptr()
> returns pointer to PMD table lock;
>
> -Split page table lock for PTE tables is enabled compile-time if
> -CONFIG_SPLIT_PTLOCK_CPUS (usually 4) is less or equal to NR_CPUS.
> -If split lock is disabled, all tables are guarded by mm->page_table_lock.
> +Split page table lock for PTE tables is enabled at compile time when
> +CONFIG_SPLIT_PTE_PTLOCKS is enabled. This option requires CONFIG_MMU and
> +CONFIG_SMP, with CONFIG_NR_CPUS set to at least 4 (see mm/Kconfig for
> +architecture-specific restrictions). If split lock is disabled, all
> +tables are guarded by mm->page_table_lock.
>
> Split page table lock for PMD tables is enabled, if it's enabled for PTE
> tables and the architecture supports it (see below).
> --
> 2.50.1
>
--
Cheers, Lorenzo
^ permalink raw reply [flat|nested] 2+ messages in thread
end of thread, other threads:[~2026-11-19 9:33 UTC | newest]
Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2026-11-19 7:48 [PATCH] Docs/mm: fix stale split page table lock references zhaozhengzhuo
2026-11-19 9:33 ` Lorenzo Stoakes (ARM)
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox
all inboxes | Powered by JetHome®