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 --- 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