doc: add a co-existence consideration for qede PMD
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
@@ -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
31/07/2019 10:02, Rasesh Mody:
Quoted 9 lines
Add and update co-existence considerations for qede PMD
Signed-off-by Rasesh Mody <[email protected]>--- 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
Hi Thomas,
Quoted 24 lines
From: Thomas Monjalon <[email protected]>
Sent: Wednesday, July 31, 2019 1:31 AM31/07/2019 10:02, Rasesh Mody:
Quoted 9 lines
Add and update co-existence considerations for qede PMD
Signed-off-by Rasesh Mody <[email protected]>--- 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 givendoc/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
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 AM31/07/2019 10:02, Rasesh Mody:
Quoted 19 lines
Add and update co-existence considerations for qede PMD
Signed-off-by Rasesh Mody <[email protected]>--- 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.
PATCH v2 1/1 doc: add a co-existence consideration for qede PMD
In reply to Rasesh ModyAdd 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
@@ -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
Jerin Jacob Kollanukkaran
AppliedQuoted 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 specificSigned-off-by Rasesh Mody <[email protected]>
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..05a6aef57100644doc/guides/nics/qede.rst +0
-0@@ -7,7 +7,7 @@ QEDE Poll Mode Driver The QEDE poll mode driver library (**librte_pmd_qede**) implementssupport 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 FeaturesCo-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