| .. 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`` |
