From: Matthew Wilcox (Oracle) Date: Tue, 22 Aug 2023 17:24:59 +0000 (+0100) Subject: hugetlb: add documentation for vma_kernel_pagesize() X-Git-Tag: v6.6.7~1970^2~11 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=8cfd014efd93e9450fcd4892bbfe8b10f41e53c3;p=platform%2Fkernel%2Flinux-starfive.git hugetlb: add documentation for vma_kernel_pagesize() This is an exported symbol, so it should have kernel-doc. Update it to mention folios, and point out that they might be larger than the supported page size for this VMA. Link: https://lkml.kernel.org/r/20230822172459.4190699-1-willy@infradead.org Signed-off-by: Matthew Wilcox (Oracle) Cc: Mike Kravetz Signed-off-by: Andrew Morton --- diff --git a/mm/hugetlb.c b/mm/hugetlb.c index cbc2582..ba6d39b 100644 --- a/mm/hugetlb.c +++ b/mm/hugetlb.c @@ -968,9 +968,14 @@ pgoff_t linear_hugepage_index(struct vm_area_struct *vma, } EXPORT_SYMBOL_GPL(linear_hugepage_index); -/* - * Return the size of the pages allocated when backing a VMA. In the majority - * cases this will be same size as used by the page table entries. +/** + * vma_kernel_pagesize - Page size granularity for this VMA. + * @vma: The user mapping. + * + * Folios in this VMA will be aligned to, and at least the size of the + * number of bytes returned by this function. + * + * Return: The default size of the folios allocated when backing a VMA. */ unsigned long vma_kernel_pagesize(struct vm_area_struct *vma) {