[dpdk-stable] [PATCH v2] doc: add a co-existence consideration for qede PMD

[dpdk-stable] [PATCH v2] doc: add a co-existence consideration for qede PMD

[Rasesh Mody]

Add and update co-existence considerations for qede PMD

v2:
Made co-existence considerations for QLogic adapters more specific

Cc: stable@dpdk.org

Signed-off-by: Rasesh Mody <rmody@marvell.com>
---
 doc/guides/nics/qede.rst | 25 ++++++++++++++++++++++---
 1 file changed, 22 insertions(+), 3 deletions(-)

diff --git a/doc/guides/nics/qede.rst b/doc/guides/nics/qede.rst
index c0a383381..05a6aef57 100644
--- a/doc/guides/nics/qede.rst
+++ b/doc/guides/nics/qede.rst
@@ -7,7 +7,7 @@ QEDE Poll Mode Driver
 
 The QEDE poll mode driver library (**librte_pmd_qede**) implements support
 for **QLogic FastLinQ QL4xxxx 10G/25G/40G/50G/100G Intelligent Ethernet Adapters (IEA) and Converged Network Adapters (CNA)** family of adapters as well as SR-IOV virtual functions (VF). It is supported on
-several standard Linux distros like RHEL7.x, SLES12.x and Ubuntu.
+several standard Linux distros like RHEL, SLES, Ubuntu etc.
 It is compile-tested under FreeBSD OS.
 
 More information can be found at `QLogic Corporation's Website
@@ -47,8 +47,27 @@ Non-supported Features
 
 Co-existence considerations
 ---------------------------
-- QLogic FastLinQ QL4xxxx CNAs can have both NIC and Storage personalities. However, coexistence with storage protocol drivers (qedi and qedf) is not supported on the same adapter. So storage personality has to be disabled on that adapter when used in DPDK applications.
-- For SR-IOV case, qede PMD will be used to bind to SR-IOV VF device and Linux native kernel driver (qede) will be attached to SR-IOV PF.
+
+- QLogic FastLinQ QL4xxxx CNAs support Ethernet, RDMA, iSCSI and FCoE
+  functionalities. These functionalities are supported using
+  QLogic Linux kernel drivers qed, qede, qedr, qedi and qedf. DPDK is
+  supported on these adapters using qede PMD.
+
+- When SR-IOV is not enabled on the adapter,
+  QLogic Linux kernel drivers (qed, qede, qedr, qedi and qedf) and qede
+  PMD can’t be attached to different PFs on a given QLogic FastLinQ
+  QL4xxx adapter.
+  A given adapter needs to be completely used by DPDK or Linux drivers
+  Before binding DPDK driver to one or more PFs on the adapter,
+  please make sure to unbind Linux drivers from all PFs of the adapter.
+  If there are multiple adapters on the system, one or more adapters
+  can be used by DPDK driver completely and other adapters can be used
+  by Linux drivers completely.
+
+- When SR-IOV is enabled on the adapter,
+  Linux kernel drivers (qed, qede, qedr, qedi and qedf) can be bound
+  to the PFs of a given adapter and either qede PMD or Linux drivers
+  (qed and qede) can be bound to the VFs of the adapter.
 
 Supported QLogic Adapters
 -------------------------
-- 
2.18.0

Re: [dpdk-stable] [PATCH v2] doc: add a co-existence consideration for qede PMD

[Jerin Jacob Kollanukkaran]

> -----Original Message-----
> From: Rasesh Mody <rmody@marvell.com>
> Sent: Monday, August 5, 2019 2:50 PM
> To: dev@dpdk.org; Thomas Monjalon <thomas@monjalon.net>
> Cc: Rasesh Mody <rmody@marvell.com>; John McNamara
> <john.mcnamara@intel.com>; Jerin Jacob Kollanukkaran
> <jerinj@marvell.com>; GR-Everest-DPDK-Dev <GR-Everest-DPDK-
> Dev@marvell.com>; stable@dpdk.org
> Subject: [PATCH v2] doc: add a co-existence consideration for qede PMD
> 
> Add and update co-existence considerations for qede PMD
> 
> v2:
> Made co-existence considerations for QLogic adapters more specific
> 
> Cc: stable@dpdk.org
> 
> Signed-off-by: Rasesh Mody <rmody@marvell.com>

Applied to dpdk-next-net-mrvl/master. Thanks


> ---
>  doc/guides/nics/qede.rst | 25 ++++++++++++++++++++++---
>  1 file changed, 22 insertions(+), 3 deletions(-)
> 
> diff --git a/doc/guides/nics/qede.rst b/doc/guides/nics/qede.rst index
> c0a383381..05a6aef57 100644
> --- a/doc/guides/nics/qede.rst
> +++ b/doc/guides/nics/qede.rst
> @@ -7,7 +7,7 @@ QEDE Poll Mode Driver
> 
>  The QEDE poll mode driver library (**librte_pmd_qede**) implements
> support  for **QLogic FastLinQ QL4xxxx 10G/25G/40G/50G/100G Intelligent
> Ethernet Adapters (IEA) and Converged Network Adapters (CNA)** family of
> adapters as well as SR-IOV virtual functions (VF). It is supported on -several
> standard Linux distros like RHEL7.x, SLES12.x and Ubuntu.
> +several standard Linux distros like RHEL, SLES, Ubuntu etc.
>  It is compile-tested under FreeBSD OS.
> 
>  More information can be found at `QLogic Corporation's Website @@ -47,8
> +47,27 @@ Non-supported Features
> 
>  Co-existence considerations
>  ---------------------------
> -- QLogic FastLinQ QL4xxxx CNAs can have both NIC and Storage
> personalities. However, coexistence with storage protocol drivers (qedi and
> qedf) is not supported on the same adapter. So storage personality has to be
> disabled on that adapter when used in DPDK applications.
> -- For SR-IOV case, qede PMD will be used to bind to SR-IOV VF device and
> Linux native kernel driver (qede) will be attached to SR-IOV PF.
> +
> +- QLogic FastLinQ QL4xxxx CNAs support Ethernet, RDMA, iSCSI and FCoE
> +  functionalities. These functionalities are supported using
> +  QLogic Linux kernel drivers qed, qede, qedr, qedi and qedf. DPDK is
> +  supported on these adapters using qede PMD.
> +
> +- When SR-IOV is not enabled on the adapter,
> +  QLogic Linux kernel drivers (qed, qede, qedr, qedi and qedf) and qede
> +  PMD can’t be attached to different PFs on a given QLogic FastLinQ
> +  QL4xxx adapter.
> +  A given adapter needs to be completely used by DPDK or Linux drivers
> +  Before binding DPDK driver to one or more PFs on the adapter,
> +  please make sure to unbind Linux drivers from all PFs of the adapter.
> +  If there are multiple adapters on the system, one or more adapters
> +  can be used by DPDK driver completely and other adapters can be used
> +  by Linux drivers completely.
> +
> +- When SR-IOV is enabled on the adapter,
> +  Linux kernel drivers (qed, qede, qedr, qedi and qedf) can be bound
> +  to the PFs of a given adapter and either qede PMD or Linux drivers
> +  (qed and qede) can be bound to the VFs of the adapter.
> 
>  Supported QLogic Adapters
>  -------------------------
> --
> 2.18.0