25 lines
839 B
ReStructuredText
25 lines
839 B
ReStructuredText
.. SPDX-License-Identifier: GPL-2.0
|
|
|
|
===============
|
|
NIC SR-IOV APIs
|
|
===============
|
|
|
|
Modern NICs are strongly encouraged to focus on implementing the ``switchdev``
|
|
model (see :ref:`switchdev`) to configure forwarding and security of SR-IOV
|
|
functionality.
|
|
|
|
Legacy API
|
|
==========
|
|
|
|
The old SR-IOV API is implemented in ``rtnetlink`` Netlink family as part of
|
|
the ``RTM_GETLINK`` and ``RTM_SETLINK`` commands. On the driver side
|
|
it consists of a number of ``ndo_set_vf_*`` and ``ndo_get_vf_*`` callbacks.
|
|
|
|
Since the legacy APIs do not integrate well with the rest of the stack
|
|
the API is considered frozen; no new functionality or extensions
|
|
will be accepted. New drivers should not implement the uncommon callbacks;
|
|
namely the following callbacks are off limits:
|
|
|
|
- ``ndo_get_vf_port``
|
|
- ``ndo_set_vf_port``
|
|
- ``ndo_set_vf_rss_query_en``
|