[PATCH] mm/pagewalk: document missing struct members

From: Oscar Alejandro Sánchez Lucero

Date: Thu Nov 12 2026 - 22:56:38 EST


Add missing kernel-doc entries for @walk_lock in struct mm_walk_ops, and
for @ptep, @pudp, @pmdp, and @vma in struct folio_walk. Also fix @pte,
@pud, and @pmd descriptions to state they hold entry values, not pointers.

Signed-off-by: Oscar Alejandro Sánchez Lucero <aleszlucero@xxxxxxxxx>
---
include/linux/pagewalk.h | 14 ++++++++++----
1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/include/linux/pagewalk.h b/include/linux/pagewalk.h
index b41d7265c01b..978714d5e32f 100644
--- a/include/linux/pagewalk.h
+++ b/include/linux/pagewalk.h
@@ -63,6 +63,8 @@ enum page_walk_lock {
* install. If allocations fail, the walk is aborted. This
* operation is only available for userland memory. Not
* usable for hugetlb ranges.
+ * @walk_lock: locking requirement during the page walk (see
+ * enum page_walk_lock).
*
* p?d_entry callbacks are called even if those levels are folded on a
* particular architecture/configuration.
@@ -161,10 +163,14 @@ enum folio_walk_level {
* struct folio_walk - folio_walk_start() / folio_walk_end() data
* @page: exact folio page referenced (if applicable)
* @level: page table level identifying the entry type
- * @pte: pointer to the page table entry (FW_LEVEL_PTE).
- * @pmd: pointer to the page table entry (FW_LEVEL_PMD).
- * @pud: pointer to the page table entry (FW_LEVEL_PUD).
- * @ptl: pointer to the page table lock.
+ * @ptep: pointer to the page table entry (FW_LEVEL_PTE).
+ * @pudp: pointer to the page table entry (FW_LEVEL_PUD).
+ * @pmdp: pointer to the page table entry (FW_LEVEL_PMD).
+ * @pte: page table entry value (FW_LEVEL_PTE).
+ * @pud: page table entry value (FW_LEVEL_PUD).
+ * @pmd: page table entry value (FW_LEVEL_PMD).
+ * @vma: pointer to the VMA (for internal use only).
+ * @ptl: pointer to the page table lock (for internal use only).
*
* (see folio_walk_start() documentation for more details)
*/

---
base-commit: 9d66f26fefacebfeed15de31c1123451a17ff119
change-id: 20261112-pagewalk-doc-d4f0de5c03c2

Best regards,
--
Oscar Alejandro Sánchez Lucero <aleszlucero@xxxxxxxxx>