sriov.rst 839 B

12345678910111213141516171819202122232425
  1. .. SPDX-License-Identifier: GPL-2.0
  2. ===============
  3. NIC SR-IOV APIs
  4. ===============
  5. Modern NICs are strongly encouraged to focus on implementing the ``switchdev``
  6. model (see :ref:`switchdev`) to configure forwarding and security of SR-IOV
  7. functionality.
  8. Legacy API
  9. ==========
  10. The old SR-IOV API is implemented in ``rtnetlink`` Netlink family as part of
  11. the ``RTM_GETLINK`` and ``RTM_SETLINK`` commands. On the driver side
  12. it consists of a number of ``ndo_set_vf_*`` and ``ndo_get_vf_*`` callbacks.
  13. Since the legacy APIs do not integrate well with the rest of the stack
  14. the API is considered frozen; no new functionality or extensions
  15. will be accepted. New drivers should not implement the uncommon callbacks;
  16. namely the following callbacks are off limits:
  17. - ``ndo_get_vf_port``
  18. - ``ndo_set_vf_port``
  19. - ``ndo_set_vf_rss_query_en``