Skip to contentSkip to conversation

Deprecation notices for VFIO

PATCH Superseded Anatoly Burakov 4 participants 10 messages Nov 19, 2025 – Mar 31

lore
Share & tools
lore
#0 lore raw

cover Deprecation notices for VFIO

There's ongoing work to rework VFIO in DPDK [1]. These deprecation notices originally were part of that patchset, but were split off to easy review and acceptance.

[1] https://patches.dpdk.org/project/dpdk/list/?series=36746

Anatoly Burakov (2):
doc: add deprecation notice for VFIO API
doc: add deprecation notice for vDPA driver API

 doc/guides/rel_notes/deprecation.rst | 7 +++++++
 1 file changed, 7 insertions(+)
Signature · 1 line
2.47.3
#1 lore raw

PATCH 1/2 doc: add deprecation notice for VFIO API

The entirety of VFIO API will be either made internal and only available to drivers, or will be removed. Add upcoming changes to deprecation notices.

---
 doc/guides/rel_notes/deprecation.rst | 4 ++++
 1 file changed, 4 insertions(+)
doc/guides/rel_notes/deprecation.rst +4 -0
index 8653d6ca03..55d3837150 100644
@@ -147,3 +147,7 @@ Deprecation Notices
   This change will not result in any feature loss,
   as the fallback scalar paths which have feature parity with SSE
   will be used in the cases where the SSE paths would have been used.
+
+* eal: The entire VFIO API (``rte_vfio_*``) will be made internal only, and will only be available to EAL and drivers.
+  Group-based API (``rte_vfio_*_group_*``) will be removed and replaced with unified container device assignment API.
+  This change will be made in 26.11 release.
Signature · 1 line
2.47.3
#2 lore raw

PATCH 2/2 doc: add deprecation notice for vDPA driver API

In reply to Anatoly Burakov

Currently, vDPA driver API is partly built around VFIO group API, which will be removed in a future release and replaced with a device container assignment API. Make this know in deprecation notice.

---
 doc/guides/rel_notes/deprecation.rst | 3 +++
 1 file changed, 3 insertions(+)
doc/guides/rel_notes/deprecation.rst +3 -0
index 55d3837150..b63dc8b715 100644
@@ -151,3 +151,6 @@ Deprecation Notices
 * eal: The entire VFIO API (``rte_vfio_*``) will be made internal only, and will only be available to EAL and drivers.
   Group-based API (``rte_vfio_*_group_*``) will be removed and replaced with unified container device assignment API.
   This change will be made in 26.11 release.
+
+* vdpa: vDPA driver API will no longer offer ``get_vfio_group_fd`` as part of its internal API.
+  All drivers will be adjusted to use the new unified VFIO container device assignment API.
Signature · 1 line
2.47.3
#3 lore raw
In reply to Anatoly Burakov
Quoted 4 lines · Anatoly Burakov

There's ongoing work to rework VFIO in DPDK [1]. These deprecation notices originally were part of that patchset, but were split off to easy review and acceptance.

Quoted 9 lines

[1] https://patches.dpdk.org/project/dpdk/list/?series=36746

Anatoly Burakov (2):
doc: add deprecation notice for VFIO API
doc: add deprecation notice for vDPA driver API

 doc/guides/rel_notes/deprecation.rst | 7 +++++++
 1 file changed, 7 insertions(+)
#4 lore raw

v2 cover Deprecation notices for VFIO

In reply to Anatoly Burakov

There's ongoing work to rework VFIO in DPDK [1]. These deprecation notices originally were part of that patchset, but were split off to easy review and acceptance.

v2:
- Rebase

[1] https://patches.dpdk.org/project/dpdk/list/?series=36765

Anatoly Burakov (2):
doc: add deprecation notice for VFIO API
doc: add deprecation notice for vDPA driver API

 doc/guides/rel_notes/deprecation.rst | 7 +++++++
 1 file changed, 7 insertions(+)
Signature · 1 line
2.47.3
#5 lore raw

PATCH v2 1/2 doc: add deprecation notice for VFIO API

The entirety of VFIO API will be either made internal and only available to drivers, or will be removed. Add upcoming changes to deprecation notices.

---
 doc/guides/rel_notes/deprecation.rst | 4 ++++
 1 file changed, 4 insertions(+)
doc/guides/rel_notes/deprecation.rst +4 -0
index ac667e91a6..a94691daf6 100644
@@ -139,3 +139,7 @@ Deprecation Notices
 * bus/vmbus: Starting DPDK 25.11, all the vmbus API defined in
   ``drivers/bus/vmbus/rte_bus_vmbus.h`` will become internal to DPDK.
   Those API functions are used internally by DPDK core and netvsc PMD.
+
+* eal: The entire VFIO API (``rte_vfio_*``) will be made internal only, and will only be available to EAL and drivers.
+  Group-based API (``rte_vfio_*_group_*``) will be removed and replaced with unified container device assignment API.
+  This change will be made in 26.11 release.
Signature · 1 line
2.47.3
#7 lore raw

PATCH v2 2/2 doc: add deprecation notice for vDPA driver API

In reply to Anatoly Burakov

Currently, vDPA driver API is partly built around VFIO group API, which will be removed in a future release and replaced with a device container assignment API. Make this know in deprecation notice.

---
 doc/guides/rel_notes/deprecation.rst | 3 +++
 1 file changed, 3 insertions(+)
doc/guides/rel_notes/deprecation.rst +3 -0
index a94691daf6..4bfbb7468e 100644
@@ -143,3 +143,6 @@ Deprecation Notices
 * eal: The entire VFIO API (``rte_vfio_*``) will be made internal only, and will only be available to EAL and drivers.
   Group-based API (``rte_vfio_*_group_*``) will be removed and replaced with unified container device assignment API.
   This change will be made in 26.11 release.
+
+* vdpa: vDPA driver API will no longer offer ``get_vfio_group_fd`` as part of its internal API.
+  All drivers will be adjusted to use the new unified VFIO container device assignment API.
Signature · 1 line
2.47.3
Acked-by on v2 2/2
#8 lore raw

Re: [PATCH v2 2/2] doc: add deprecation notice for vDPA driver API

Quoted 7 lines · Anatoly Burakov

Currently, vDPA driver API is partly built around VFIO group API, which will be removed in a future release and replaced with a device container assignment API. Make this know in deprecation notice.

Signature · 1 line
David Marchand
Acked-by Bruce Richardson Acked-by David Marchand Acked-by on the v2 series Applied
#9 lore raw
In reply to Anatoly Burakov

26/02/2026 14:59, Anatoly Burakov:

Quoted 3 lines

There's ongoing work to rework VFIO in DPDK [1]. These deprecation notices originally were part of that patchset, but were split off to easy review and acceptance.

Applied, thanks.