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

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

[Rasesh Mody]

Add and update co-existence considerations for qede PMD

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

diff --git a/doc/guides/nics/qede.rst b/doc/guides/nics/qede.rst
index c0a383381..87cf989c1 100644
--- a/doc/guides/nics/qede.rst
+++ b/doc/guides/nics/qede.rst
@@ -47,8 +47,25 @@ 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 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.
+
+- Linux kernel drivers and qede PMD can’t be mixed on a given FastLinQ
+  QL4xxx adapter. This type of coexistence is unsupported. A given
+  adapter needs to be completely used by DPDK or Linux drivers, when
+  SR-IOV is not enabled. Before binging DPDK driver to one or more
+  devices on the adapter, please make sure to unbind Linux drivers from
+  all devices of the adapter. If there are multiple adapters on the
+  system, one or more adapter can be used by DPDK driver and other
+  adapters can be used by Linux drivers.
+
+- When SR-IOV is enabled, Linux native kernel driver (qede) can be bound
+  to the PFs of a given adapter and either DPDK or Linux drivers can be
+  bound to the VFs of the adapter.
 
 Supported QLogic Adapters
 -------------------------
-- 
2.18.0

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

[Thomas Monjalon]

31/07/2019 10:02, Rasesh Mody:
> Add and update co-existence considerations for qede PMD
> 
> Signed-off-by: Rasesh Mody <rmody@marvell.com>
> ---
>  doc/guides/nics/qede.rst | 21 +++++++++++++++++++--
>  1 file changed, 19 insertions(+), 2 deletions(-)
> 
> +- Linux kernel drivers and qede PMD can’t be mixed on a given FastLinQ
> +  QL4xxx adapter. This type of coexistence is unsupported. A given
> +  adapter needs to be completely used by DPDK or Linux drivers, when
> +  SR-IOV is not enabled. Before binging DPDK driver to one or more
> +  devices on the adapter, please make sure to unbind Linux drivers from
> +  all devices of the adapter. If there are multiple adapters on the
> +  system, one or more adapter can be used by DPDK driver and other
> +  adapters can be used by Linux drivers.
> +
> +- When SR-IOV is enabled, Linux native kernel driver (qede) can be bound
> +  to the PFs of a given adapter and either DPDK or Linux drivers can be
> +  bound to the VFs of the adapter.

This part is not specific to qede, but related to UIO/VFIO behaviour.
I think we already have this kind of explanation in the Linux guide.
If not, please update it and add a reference link from here.
Thanks

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

[Rasesh Mody]

Hi Thomas,

>From: Thomas Monjalon <thomas@monjalon.net>
>Sent: Wednesday, July 31, 2019 1:31 AM
>
>31/07/2019 10:02, Rasesh Mody:
>> Add and update co-existence considerations for qede PMD
>>
>> Signed-off-by: Rasesh Mody <rmody@marvell.com>
>> ---
>>  doc/guides/nics/qede.rst | 21 +++++++++++++++++++--
>>  1 file changed, 19 insertions(+), 2 deletions(-)
>>
>> +- Linux kernel drivers and qede PMD can’t be mixed on a given FastLinQ
>> +  QL4xxx adapter. This type of coexistence is unsupported. A given
>> +  adapter needs to be completely used by DPDK or Linux drivers, when
>> +  SR-IOV is not enabled. Before binging DPDK driver to one or more
>> +  devices on the adapter, please make sure to unbind Linux drivers from
>> +  all devices of the adapter. If there are multiple adapters on the
>> +  system, one or more adapter can be used by DPDK driver and other
>> +  adapters can be used by Linux drivers.
>> +
>> +- When SR-IOV is enabled, Linux native kernel driver (qede) can be bound
>> +  to the PFs of a given adapter and either DPDK or Linux drivers can be
>> +  bound to the VFs of the adapter.
>
>This part is not specific to qede, but related to UIO/VFIO behaviour.
>I think we already have this kind of explanation in the Linux guide.
>If not, please update it and add a reference link from here.

I've sent updated v2 version of co-existence consideration for Qlogic adapters. These considerations are specific to qede PMD. Usage of DPDK and QLogic Linux drivers across multiple PFs on the same adapter is not possible and unique for our architecture. We do not want to add notes regarding UIO/VFIO behavior here as its common to others as well.

Thanks!
-Rasesh
 
>Thanks
>

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

[Thomas Monjalon]

05/08/2019 11:26, Rasesh Mody:
> Hi Thomas,
> 
> >From: Thomas Monjalon <thomas@monjalon.net>
> >Sent: Wednesday, July 31, 2019 1:31 AM
> >
> >31/07/2019 10:02, Rasesh Mody:
> >> Add and update co-existence considerations for qede PMD
> >>
> >> Signed-off-by: Rasesh Mody <rmody@marvell.com>
> >> ---
> >>  doc/guides/nics/qede.rst | 21 +++++++++++++++++++--
> >>  1 file changed, 19 insertions(+), 2 deletions(-)
> >>
> >> +- Linux kernel drivers and qede PMD can’t be mixed on a given FastLinQ
> >> +  QL4xxx adapter. This type of coexistence is unsupported. A given
> >> +  adapter needs to be completely used by DPDK or Linux drivers, when
> >> +  SR-IOV is not enabled. Before binging DPDK driver to one or more
> >> +  devices on the adapter, please make sure to unbind Linux drivers from
> >> +  all devices of the adapter. If there are multiple adapters on the
> >> +  system, one or more adapter can be used by DPDK driver and other
> >> +  adapters can be used by Linux drivers.
> >> +
> >> +- When SR-IOV is enabled, Linux native kernel driver (qede) can be bound
> >> +  to the PFs of a given adapter and either DPDK or Linux drivers can be
> >> +  bound to the VFs of the adapter.
> >
> >This part is not specific to qede, but related to UIO/VFIO behaviour.
> >I think we already have this kind of explanation in the Linux guide.
> >If not, please update it and add a reference link from here.
> 
> I've sent updated v2 version of co-existence consideration for Qlogic adapters. These considerations are specific to qede PMD. Usage of DPDK and QLogic Linux drivers across multiple PFs on the same adapter is not possible and unique for our architecture. We do not want to add notes regarding UIO/VFIO behavior here as its common to others as well.

OK, looks good.

[dpdk-dev] [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-dev] [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