From: Christoph Hellwig Date: Thu, 13 Nov 2025 08:39:43 +0000 (+0100) Subject: mm: improve kerneldoc comments for __alloc_pages_bulk X-Git-Tag: v6.19-rc1~183^2^2~10 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=e9939cebc0be8dabb1798b357e9dadf6398fa859;p=thirdparty%2Fkernel%2Flinux.git mm: improve kerneldoc comments for __alloc_pages_bulk Describe the semantincs in more detail, as the filling empty slots in an array scheme is not quite obvious. Signed-off-by: Christoph Hellwig Link: https://patch.msgid.link/20251113084022.1255121-3-hch@lst.de Signed-off-by: Vlastimil Babka --- diff --git a/mm/page_alloc.c b/mm/page_alloc.c index 600d9e981c23d..b3d37169a5539 100644 --- a/mm/page_alloc.c +++ b/mm/page_alloc.c @@ -4982,13 +4982,18 @@ static inline bool prepare_alloc_pages(gfp_t gfp_mask, unsigned int order, * @nr_pages: The number of pages desired in the array * @page_array: Array to store the pages * - * This is a batched version of the page allocator that attempts to - * allocate nr_pages quickly. Pages are added to the page_array. + * This is a batched version of the page allocator that attempts to allocate + * @nr_pages quickly. Pages are added to @page_array. * - * Note that only NULL elements are populated with pages and nr_pages - * is the maximum number of pages that will be stored in the array. + * Note that only the elements in @page_array that were cleared to %NULL on + * entry are populated with newly allocated pages. @nr_pages is the maximum + * number of pages that will be stored in the array. * - * Returns the number of pages in the array. + * Returns the number of pages in @page_array, including ones already + * allocated on entry. This can be less than the number requested in @nr_pages, + * but all empty slots are filled from the beginning. I.e., if all slots in + * @page_array were set to %NULL on entry, the slots from 0 to the return value + * - 1 will be filled. */ unsigned long alloc_pages_bulk_noprof(gfp_t gfp, int preferred_nid, nodemask_t *nodemask, int nr_pages,