doc: add a co-existence consideration for qede PMD

Message ID 20190731080207.19167-1-rmody@marvell.com (mailing list archive)
State Superseded, archived
Headers
Series doc: add a co-existence consideration for qede PMD |

Checks

Context Check Description
ci/checkpatch success coding style OK
ci/Intel-compilation success Compilation OK

Commit Message

Rasesh Mody July 31, 2019, 8:02 a.m. UTC
  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(-)
  

Comments

Thomas Monjalon July 31, 2019, 8:31 a.m. UTC | #1
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
  
Rasesh Mody Aug. 5, 2019, 9:26 a.m. UTC | #2
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
>
  
Thomas Monjalon Aug. 5, 2019, 10:16 a.m. UTC | #3
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.
  

Patch

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