Skip to contentSkip to conversation

doc: add a co-existence consideration for qede PMD

PATCH Superseded Rasesh Mody 3 participants 6 messages Jul 31, 2019 – Aug 5, 2019

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 doc: add a co-existence consideration for qede PMD

Add and update co-existence considerations for qede PMD

---
 doc/guides/nics/qede.rst | 21 +++++++++++++++++++--
 1 file changed, 19 insertions(+), 2 deletions(-)
doc/guides/nics/qede.rst +19 -2
index c0a383381..87cf989c1 100644
@@ -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
 -------------------------
Signature · 1 line
2.18.0
#1 lore raw

31/07/2019 10:02, Rasesh Mody:

Quoted 9 lines

Add and update co-existence considerations for qede PMD

---
 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

doc/guides/nics/qede.rst +1 -0
+  QL4xxx adapter. This type of coexistence is unsupported. A given

doc/guides/nics/qede.rst Non-supported Features · line 68

Quoted 10 lines
doc/guides/nics/qede.rst +10 -0
+  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

#2 lore raw

Hi Thomas,

Quoted 24 lines

From: Thomas Monjalon <[email protected]>
Sent: Wednesday, July 31, 2019 1:31 AM

31/07/2019 10:02, Rasesh Mody:

Quoted 9 lines

Add and update co-existence considerations for qede PMD

---
 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

doc/guides/nics/qede.rst +1 -0
+  QL4xxx adapter. This type of coexistence is unsupported. A given

doc/guides/nics/qede.rst Non-supported Features · line 68

Quoted 10 lines
doc/guides/nics/qede.rst +10 -0
+  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.
Quoted 3 lines

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

Quoted 2 lines

Thanks

#3 lore raw

05/08/2019 11:26, Rasesh Mody:

Quoted 26 lines

Hi Thomas,

Quoted 24 lines

From: Thomas Monjalon <[email protected]>
Sent: Wednesday, July 31, 2019 1:31 AM

31/07/2019 10:02, Rasesh Mody:

Quoted 19 lines

Add and update co-existence considerations for qede PMD

---
 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

doc/guides/nics/qede.rst +11 -0
+  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.
Quoted 5 lines
Quoted 3 lines

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.

#4 lore raw

PATCH v2 1/1 doc: add a co-existence consideration for qede PMD

In reply to Rasesh Mody

Add and update co-existence considerations for qede PMD

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

---
 doc/guides/nics/qede.rst | 25 ++++++++++++++++++++++---
 1 file changed, 22 insertions(+), 3 deletions(-)
doc/guides/nics/qede.rst +22 -3
index c0a383381..05a6aef57 100644
@@ -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
 -------------------------
Signature · 1 line
2.18.0
#5 lore raw
Quoted 10 lines

-----Original Message-----
From: Rasesh Mody <[email protected]>
Sent: Monday, August 5, 2019 2:50 PM
To: [email protected]; Thomas Monjalon <[email protected]>
Cc: Rasesh Mody <[email protected]>; John McNamara <[email protected]>; Jerin Jacob Kollanukkaran <[email protected]>; GR-Everest-DPDK-Dev <GR-Everest-DPDK- [email protected]>; [email protected]
Subject: [PATCH v2] doc: add a co-existence consideration for qede PMD

Quoted 8 lines

Add and update co-existence considerations for qede PMD

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

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

Quoted 55 lines
---
 doc/guides/nics/qede.rst | 25 ++++++++++++++++++++++---
 1 file changed, 22 insertions(+), 3 deletions(-)
doc/guides/nics/qede.rst index renamed from doc/guides/nics/qede.rst +0 -0

c0a383381..05a6aef57 100644

doc/guides/nics/qede.rst +0 -0
@@ -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.

doc/guides/nics/qede.rst +21 -1
+
+- 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