page_pool: introduce page_pool_alloc() API 10/309710/1
authorYunsheng Lin <linyunsheng@huawei.com>
Fri, 20 Oct 2023 09:59:50 +0000 (17:59 +0800)
committerJaehoon Chung <jh80.chung@samsung.com>
Tue, 16 Apr 2024 02:24:50 +0000 (11:24 +0900)
commit564415c41bb7f7d7c8c76a1944432836959c799c
tree7f3e600e9d721b68e387770de7435cd28d430831
parente662056480461dcb37c588f708f00191e0be3222
page_pool: introduce page_pool_alloc() API

Currently page pool supports the below use cases:
use case 1: allocate page without page splitting using
            page_pool_alloc_pages() API if the driver knows
            that the memory it need is always bigger than
            half of the page allocated from page pool.
use case 2: allocate page frag with page splitting using
            page_pool_alloc_frag() API if the driver knows
            that the memory it need is always smaller than
            or equal to the half of the page allocated from
            page pool.

There is emerging use case [1] & [2] that is a mix of the
above two case: the driver doesn't know the size of memory it
need beforehand, so the driver may use something like below to
allocate memory with least memory utilization and performance
penalty:

if (size << 1 > max_size)
page = page_pool_alloc_pages();
else
page = page_pool_alloc_frag();

To avoid the driver doing something like above, add the
page_pool_alloc() API to support the above use case, and update
the true size of memory that is acctually allocated by updating
'*size' back to the driver in order to avoid exacerbating
truesize underestimate problem.

Rename page_pool_free() which is used in the destroy process to
__page_pool_destroy() to avoid confusion with the newly added
API.

1. https://lore.kernel.org/all/d3ae6bd3537fbce379382ac6a42f67e22f27ece2.1683896626.git.lorenzo@kernel.org/
2. https://lore.kernel.org/all/20230526054621.18371-3-liangchen.linux@gmail.com/

Signed-off-by: Yunsheng Lin <linyunsheng@huawei.com>
CC: Lorenzo Bianconi <lorenzo@kernel.org>
CC: Alexander Duyck <alexander.duyck@gmail.com>
CC: Liang Chen <liangchen.linux@gmail.com>
CC: Alexander Lobakin <aleksander.lobakin@intel.com>
Link: https://lore.kernel.org/r/20231020095952.11055-4-linyunsheng@huawei.com
Signed-off-by: Jakub Kicinski <kuba@kernel.org>
(cherry picked from commit de97502e16fc406a74edee8359612e518986cf59)
Signed-off-by: Jaehoon Chung <jh80.chung@samsung.com>
Change-Id: I56b80851e1e18980521292771e13177698fee12e
include/net/page_pool/helpers.h
net/core/page_pool.c