page_pool: add a comment explaining the fragment counter usage
authorIlias Apalodimas <ilias.apalodimas@linaro.org>
Fri, 17 Feb 2023 22:21:30 +0000 (00:21 +0200)
committerJakub Kicinski <kuba@kernel.org>
Tue, 21 Feb 2023 17:15:39 +0000 (09:15 -0800)
commit4d4266e3fd321fadb628ce02de641b129522c39c
tree3a3b01a058c6b6deb48ef8f14630d1eae7bef589
parenta00da30c052f07d67da56efd6a4f1fc85956c979
page_pool: add a comment explaining the fragment counter usage

When reading the page_pool code the first impression is that keeping
two separate counters, one being the page refcnt and the other being
fragment pp_frag_count, is counter-intuitive.

However without that fragment counter we don't know when to reliably
destroy or sync the outstanding DMA mappings.  So let's add a comment
explaining this part.

Reviewed-by: Alexander Duyck <alexanderduyck@fb.com>
Signed-off-by: Ilias Apalodimas <ilias.apalodimas@linaro.org>
Acked-by: Jesper Dangaard Brouer <brouer@redhat.com>
Link: https://lore.kernel.org/r/20230217222130.85205-1-ilias.apalodimas@linaro.org
Signed-off-by: Jakub Kicinski <kuba@kernel.org>
include/net/page_pool.h