]> www.infradead.org Git - users/dwmw2/linux.git/commit
mm/page_alloc: clarify should_claim_block() commentary
authorBrendan Jackman <jackmanb@google.com>
Fri, 28 Feb 2025 09:52:18 +0000 (09:52 +0000)
committerAndrew Morton <akpm@linux-foundation.org>
Mon, 17 Mar 2025 07:05:35 +0000 (00:05 -0700)
commita14efee04796dd3f614eaf5348ca1ac099c21349
treea62652731dc8f03bafcb2f8e4737dde23dab27ad
parente47f1f56dd82cc6d91f5c4d914a534aa03cd12ca
mm/page_alloc: clarify should_claim_block() commentary

There's lots of text here but it's a little hard to follow, this is an
attempt to break it up and align its structure more closely with the code.

Reword the top-level function comment to just explain what question the
function answers from the point of view of the caller.

Break up the internal logic into different sections that can have their
own commentary describing why that part of the rationale is present.

Note the page_group_by_mobility_disabled logic is not explained in the
commentary, that is outside the scope of this patch...

Link: https://lkml.kernel.org/r/20250228-clarify-steal-v4-2-cb2ef1a4e610@google.com
Signed-off-by: Brendan Jackman <jackmanb@google.com>
Reviewed-by: Vlastimil Babka <vbabka@suse.cz>
Cc: Johannes Weiner <hannes@cmpxchg.org>
Cc: Mel Gorman <mgorman@techsingularity.net>
Cc: Michal Hocko <mhocko@kernel.org>
Cc: Yosry Ahmed <yosry.ahmed@linux.dev>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
mm/page_alloc.c