jsauer/torvalds-linux
1
0
Fork 0
mirror of https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git synced 2026-01-11 17:10:13 +00:00
Code

netlink: specs: netdev: clarify the page pool API a little

Browse Source 
The phrasing of the page-pool-get doc is very confusing.
It's supposed to highlight that support depends on the driver
doing its part but it sounds like orphaned page pools won't
be visible.

The description of the ifindex is completely wrong.
We move the page pool to loopback and skip the attribute if
ifindex is loopback.

Link: https://lore.kernel.org/20260104084347.5de3a537@kernel.org
Reviewed-by: Donald Hunter <donald.hunter@gmail.com>
Acked-by: Jesper Dangaard Brouer <hawk@kernel.org>
Link: https://patch.msgid.link/20260104165232.710460-1-kuba@kernel.org
Signed-off-by: Jakub Kicinski <kuba@kernel.org>
This commit is contained in:
Jakub Kicinski 2026-01-04 08:52:32 -08:00
parent a7fc8c641c
commit 86c22d475c
1 changed files with 4 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
Documentation/netlink/specs/netdev.yaml
View File

@ -142,7 +142,7 @@ attribute-sets:
name: ifindex name: ifindex
doc: | doc: |
ifindex of the netdev to which the pool belongs. ifindex of the netdev to which the pool belongs.
May be reported as 0 if the page pool was allocated for a netdev May not be reported if the page pool was allocated for a netdev
which got destroyed already (page pools may outlast their netdevs which got destroyed already (page pools may outlast their netdevs
because they wait for all memory to be returned). because they wait for all memory to be returned).
type: u32 type: u32
@ -601,7 +601,9 @@ operations:
name: page-pool-get name: page-pool-get
doc: | doc: |
Get / dump information about Page Pools. Get / dump information about Page Pools.
(Only Page Pools associated with a net_device can be listed.) Only Page Pools associated by the driver with a net_device
can be listed. ifindex will not be reported if the net_device
no longer exists.
attribute-set: page-pool attribute-set: page-pool
do: do:
request: request: