admin/linux
1
0
Fork 0
mirror of https://github.com/torvalds/linux.git synced 2025-12-07 20:06:24 +00:00
Code Issues Packages Projects Releases Wiki Activity

mm: improve kerneldoc comments for __alloc_pages_bulk

Browse Source 
Describe the semantincs in more detail, as the filling empty slots in
an array scheme is not quite obvious.

Signed-off-by: Christoph Hellwig <hch@lst.de>
Link: https://patch.msgid.link/20251113084022.1255121-3-hch@lst.de
Signed-off-by: Vlastimil Babka <vbabka@suse.cz>
This commit is contained in:
Christoph Hellwig
2025-11-13 09:39:43 +01:00
committed by Vlastimil Babka
parent 0f2620ffc4
commit e9939cebc0
1 changed files with 10 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

15
mm/page_alloc.c
View File

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