docs: net: document guidance of implementing the SR-IOV NDOs
authorJakub Kicinski <kuba@kernel.org>
Thu, 20 Jun 2024 00:27:41 +0000 (17:27 -0700)
committerDavid S. Miller <davem@davemloft.net>
Fri, 21 Jun 2024 09:18:45 +0000 (10:18 +0100)
commit4558645d139c01d5635cac7e3528a3d19bbb6526
treee3de6b09720ab6560eb240df01832c47edd5c6d4
parentdcec8d291da8813b5e1c7c0967ae63463a8521f6
docs: net: document guidance of implementing the SR-IOV NDOs

New drivers were prevented from adding ndo_set_vf_* callbacks
over the last few years. This was expected to result in broader
switchdev adoption, but seems to have had little effect.

Based on recent netdev meeting there is broad support for allowing
adding those ops.

There is a problem with the current API supporting a limited number
of VFs (100+, which is less than some modern HW supports).
We can try to solve it by adding similar functionality on devlink
ports, but that'd be another API variation to maintain.
So a netlink attribute reshuffling is a more likely outcome.

Document the guidance, make it clear that the API is frozen.

Signed-off-by: Jakub Kicinski <kuba@kernel.org>
Reviewed-by: Randy Dunlap <rdunlap@infradead.org>
Reviewed-by: Simon Horman <horms@kernel.org>
Signed-off-by: David S. Miller <davem@davemloft.net>
Documentation/networking/index.rst
Documentation/networking/sriov.rst [new file with mode: 0644]