diff mbox series

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

Message ID	20210927102157.1570116-13-conor.walsh@intel.com (mailing list archive)
State	Superseded, archived
Delegated to:	Thomas Monjalon
Headers	From: Conor Walsh <conor.walsh@intel.com> To: bruce.richardson@intel.com, fengchengwen@huawei.com, jerinj@marvell.com, kevin.laatz@intel.com Cc: dev@dpdk.org, Conor Walsh <conor.walsh@intel.com> Date: Mon, 27 Sep 2021 10:21:57 +0000 Message-Id: <20210927102157.1570116-13-conor.walsh@intel.com> In-Reply-To: <20210927102157.1570116-1-conor.walsh@intel.com> References: <20210827172550.1522362-1-conor.walsh@intel.com> <20210927102157.1570116-1-conor.walsh@intel.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Subject: [dpdk-dev] [PATCH v6 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 \| [v6,00/12] dma: add dmadev driver for ioat devices [v6,01/12] dma/ioat: add device probe and removal functions [v6,02/12] dma/ioat: create dmadev instances on PCI probe [v6,03/12] dma/ioat: add datapath structures [v6,04/12] dma/ioat: add configuration functions [v6,05/12] dma/ioat: add start and stop functions [v6,06/12] dma/ioat: add data path job submission functions [v6,07/12] dma/ioat: add data path completion functions [v6,08/12] dma/ioat: add statistics [v6,09/12] dma/ioat: add support for vchan status function [v6,10/12] dma/ioat: add burst capacity function [v6,11/12] devbind: move ioat device IDs to dmadev category [v6,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 Sept. 27, 2021, 10:21 a.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>
---
 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 ccabba9169..a4bcd2d024 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 59445a6f42..b1dbb45802 100644
--- a/doc/guides/rel_notes/deprecation.rst
+++ b/doc/guides/rel_notes/deprecation.rst
@@ -284,3 +284,10 @@  Deprecation Notices
   reserved bytes to 2 (from 3), and use 1 byte to indicate warnings and other
   information from the crypto/security operation. This field will be used to
   communicate events such as soft expiry with IPsec in lookaside mode.
+
+* 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