diff mbox series

[v8,12/12] raw/ioat: deprecate ioat rawdev driver

Message ID	20211018123835.1080174-13-conor.walsh@intel.com (mailing list archive)
State	Accepted, archived
Delegated to:	Thomas Monjalon
Headers	From: Conor Walsh <conor.walsh@intel.com> To: bruce.richardson@intel.com, thomas@monjalon.net, fengchengwen@huawei.com, jerinj@marvell.com, kevin.laatz@intel.com Cc: dev@dpdk.org, Conor Walsh <conor.walsh@intel.com> Date: Mon, 18 Oct 2021 12:38:35 +0000 Message-Id: <20211018123835.1080174-13-conor.walsh@intel.com> In-Reply-To: <20211018123835.1080174-1-conor.walsh@intel.com> References: <20210827172550.1522362-1-conor.walsh@intel.com> <20211018123835.1080174-1-conor.walsh@intel.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Subject: [dpdk-dev] [PATCH v8 12/12] raw/ioat: deprecate ioat rawdev driver Precedence: list Errors-To: dev-bounces@dpdk.org Sender: "dev" <dev-bounces@dpdk.org>
Series	dma: add dmadev driver for ioat devices \| [v8,00/12] dma: add dmadev driver for ioat devices [v8,01/12] dma/ioat: add device probe and removal functions [v8,02/12] dma/ioat: create dmadev instances on PCI probe [v8,03/12] dma/ioat: add datapath structures [v8,04/12] dma/ioat: add configuration functions [v8,05/12] dma/ioat: add start and stop functions [v8,06/12] dma/ioat: add data path job submission functions [v8,07/12] dma/ioat: add data path completion functions [v8,08/12] dma/ioat: add statistics [v8,09/12] dma/ioat: add support for vchan status function [v8,10/12] dma/ioat: add burst capacity function [v8,11/12] devbind: move ioat device IDs to dmadev category [v8,12/12] raw/ioat: deprecate ioat rawdev driver

Checks

Context	Check	Description
ci/checkpatch	success	coding style OK
ci/Intel-compilation	warning	apply issues

Commit Message

Conor Walsh Oct. 18, 2021, 12:38 p.m. UTC

  Deprecate the rawdev IOAT driver as both IOAT and IDXD drivers have
moved to dmadev.

Signed-off-by: Conor Walsh <conor.walsh@intel.com>
Acked-by: Kevin Laatz <kevin.laatz@intel.com>
Acked-by: Bruce Richardson <bruce.richardson@intel.com>
Acked-by: Thomas Monjalon <thomas@monjalon.net>
---
 MAINTAINERS                          | 2 +-
 doc/guides/rawdevs/ioat.rst          | 4 ++++
 doc/guides/rel_notes/deprecation.rst | 7 +++++++
 3 files changed, 12 insertions(+), 1 deletion(-)

diff mbox series

Patch

diff --git a/MAINTAINERS b/MAINTAINERS
index 283c70f7d7..b9f7746dc4 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -1322,7 +1322,7 @@  T: git://dpdk.org/next/dpdk-next-net-intel
 F: drivers/raw/ifpga/
 F: doc/guides/rawdevs/ifpga.rst
 
-IOAT Rawdev
+IOAT Rawdev - DEPRECATED
 M: Bruce Richardson <bruce.richardson@intel.com>
 F: drivers/raw/ioat/
 F: doc/guides/rawdevs/ioat.rst
diff --git a/doc/guides/rawdevs/ioat.rst b/doc/guides/rawdevs/ioat.rst
index a65530bd30..98d15dd032 100644
--- a/doc/guides/rawdevs/ioat.rst
+++ b/doc/guides/rawdevs/ioat.rst
@@ -6,6 +6,10 @@ 
 IOAT Rawdev Driver
 ===================
 
+.. warning::
+        As of DPDK 21.11 the rawdev implementation of the IOAT driver has been deprecated.
+        Please use the dmadev library instead.
+
 The ``ioat`` rawdev driver provides a poll-mode driver (PMD) for Intel\ |reg|
 Data Streaming Accelerator `(Intel DSA)
 <https://01.org/blogs/2019/introducing-intel-data-streaming-accelerator>`_ and for Intel\ |reg|
diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst
index 45239ca56e..1014c45bc5 100644
--- a/doc/guides/rel_notes/deprecation.rst
+++ b/doc/guides/rel_notes/deprecation.rst
@@ -236,3 +236,10 @@  Deprecation Notices
 * cmdline: ``cmdline`` structure will be made opaque to hide platform-specific
   content. On Linux and FreeBSD, supported prior to DPDK 20.11,
   original structure will be kept until DPDK 21.11.
+
+* raw/ioat: The ``ioat`` rawdev driver has been deprecated, since it's
+  functionality is provided through the new ``dmadev`` infrastructure.
+  To continue to use hardware previously supported by the ``ioat`` rawdev driver,
+  applications should be updated to use the ``dmadev`` library instead,
+  with the underlying HW-functionality being provided by the ``ioat`` or
+  ``idxd`` dma drivers