DPDK patches and discussions
 help / color / mirror / Atom feed
* [dpdk-dev] [PATCH] doc: add known igb_uio issue for i40e
@ 2017-03-27  9:16 Qiming Yang
  2017-03-30 12:08 ` Wu, Jingjing
                   ` (2 more replies)
  0 siblings, 3 replies; 9+ messages in thread
From: Qiming Yang @ 2017-03-27  9:16 UTC (permalink / raw)
  To: dev; +Cc: Qiming Yang

When insmod "igb_uio" with "intr_mode=legacy and test link
status interrupt. Since INTx interrupt is not supported by
X710/XL710/XXV710, it will cause Input/Output error when
reading file descriptor.

Signed-off-by: Qiming Yang <qiming.yang@intel.com>
---
 doc/guides/nics/i40e.rst | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/doc/guides/nics/i40e.rst b/doc/guides/nics/i40e.rst
index 043de34..f4073c2 100644
--- a/doc/guides/nics/i40e.rst
+++ b/doc/guides/nics/i40e.rst
@@ -467,3 +467,16 @@ Incorrect Rx statistics when packet is oversize
 When a packet is over maximum frame size, the packet is dropped.
 However the Rx statistics, when calling `rte_eth_stats_get` incorrectly
 shows it as received.
+
+igb uio legacy mode can not be used in X710/XL710/XXV710
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+When insmod ``igb_uio`` with ``intr_mode=legacy`` and test link status
+interrupt, it will cause Input/Output error when reading file descriptor.
+The root cause is X710/XL710/XXV710 NICs lack support for indicating INTx
+is asserted via the interrupt bit in the PCI status register. Linux delect
+them from INTx support table. The related link `linux kernel commit <https:
+//git.kernel.org/pub/scm/linux/kernel/git/stable/linux-stable.git/commit/
+drivers/pci/quirks.c?id=8bcf4525c5d43306c5fd07e132bc8650e3491aec>`_.
+
+NOTE: happening when Linux kernel version >= 4.7
-- 
2.7.4

^ permalink raw reply	[flat|nested] 9+ messages in thread

* Re: [dpdk-dev] [PATCH] doc: add known igb_uio issue for i40e
  2017-03-27  9:16 [dpdk-dev] [PATCH] doc: add known igb_uio issue for i40e Qiming Yang
@ 2017-03-30 12:08 ` Wu, Jingjing
  2017-04-03 10:40 ` Ferruh Yigit
  2017-04-13  3:08 ` [dpdk-dev] [PATCH v2] " Qiming Yang
  2 siblings, 0 replies; 9+ messages in thread
From: Wu, Jingjing @ 2017-03-30 12:08 UTC (permalink / raw)
  To: Yang, Qiming, dev; +Cc: Yang, Qiming



> -----Original Message-----
> From: dev [mailto:dev-bounces@dpdk.org] On Behalf Of Qiming Yang
> Sent: Monday, March 27, 2017 5:16 PM
> To: dev@dpdk.org
> Cc: Yang, Qiming <qiming.yang@intel.com>
> Subject: [dpdk-dev] [PATCH] doc: add known igb_uio issue for i40e
> 
> When insmod "igb_uio" with "intr_mode=legacy and test link status interrupt.
> Since INTx interrupt is not supported by X710/XL710/XXV710, it will cause
> Input/Output error when reading file descriptor.
> 
> Signed-off-by: Qiming Yang <qiming.yang@intel.com>

Acked-by Jingjing Wu <jingjing.wu@intel.com>

^ permalink raw reply	[flat|nested] 9+ messages in thread

* Re: [dpdk-dev] [PATCH] doc: add known igb_uio issue for i40e
  2017-03-27  9:16 [dpdk-dev] [PATCH] doc: add known igb_uio issue for i40e Qiming Yang
  2017-03-30 12:08 ` Wu, Jingjing
@ 2017-04-03 10:40 ` Ferruh Yigit
  2017-04-03 13:30   ` Mcnamara, John
  2017-04-13  3:08 ` [dpdk-dev] [PATCH v2] " Qiming Yang
  2 siblings, 1 reply; 9+ messages in thread
From: Ferruh Yigit @ 2017-04-03 10:40 UTC (permalink / raw)
  To: Qiming Yang, dev, John McNamara, Thomas Monjalon

On 3/27/2017 10:16 AM, Qiming Yang wrote:
> When insmod "igb_uio" with "intr_mode=legacy and test link
> status interrupt. Since INTx interrupt is not supported by
> X710/XL710/XXV710, it will cause Input/Output error when
> reading file descriptor.
> 
> Signed-off-by: Qiming Yang <qiming.yang@intel.com>
> ---
>  doc/guides/nics/i40e.rst | 13 +++++++++++++

Hi John,

There are three different "Known Issue" sections in documentations:

1) Known Issues document, doc/guides/rel_notes/known_issues.rst
2) Release notes, known issues section,
doc/guides/rel_notes/release_17_05.rst
3) Device specific known issues sections, doc/guides/nics/i40e.rst


This patch updates 3), what is the rule on updating those files?


Thanks,
ferruh

^ permalink raw reply	[flat|nested] 9+ messages in thread

* Re: [dpdk-dev] [PATCH] doc: add known igb_uio issue for i40e
  2017-04-03 10:40 ` Ferruh Yigit
@ 2017-04-03 13:30   ` Mcnamara, John
  0 siblings, 0 replies; 9+ messages in thread
From: Mcnamara, John @ 2017-04-03 13:30 UTC (permalink / raw)
  To: Yigit, Ferruh, Yang, Qiming, dev, Thomas Monjalon



> -----Original Message-----
> From: Yigit, Ferruh
> Sent: Monday, April 3, 2017 11:40 AM
> To: Yang, Qiming <qiming.yang@intel.com>; dev@dpdk.org; Mcnamara, John
> <john.mcnamara@intel.com>; Thomas Monjalon <thomas.monjalon@6wind.com>
> Subject: Re: [dpdk-dev] [PATCH] doc: add known igb_uio issue for i40e
> 
> On 3/27/2017 10:16 AM, Qiming Yang wrote:
> > When insmod "igb_uio" with "intr_mode=legacy and test link status
> > interrupt. Since INTx interrupt is not supported by X710/XL710/XXV710,
> > it will cause Input/Output error when reading file descriptor.
> >
> > Signed-off-by: Qiming Yang <qiming.yang@intel.com>
> > ---
> >  doc/guides/nics/i40e.rst | 13 +++++++++++++
> 
> Hi John,
> 
> There are three different "Known Issue" sections in documentations:
> 
> 1) Known Issues document, doc/guides/rel_notes/known_issues.rst
> 2) Release notes, known issues section,
> doc/guides/rel_notes/release_17_05.rst
> 3) Device specific known issues sections, doc/guides/nics/i40e.rst
> 
> 
> This patch updates 3), what is the rule on updating those files?
> 

Hi,

I was going to make a similar comment on the patchset.

Having "known" issues in three places is a good way of keeping them unknown.

Ideally the process should be:
    1. Add new "known" issues into the release notes.
    2. Move these to known_issues.rst after each release.

This is a little too manual, so perhaps known issues should be added directly 
to known_issues.rst under a header for the release they were identified in.
The release notes could contain a link to known_issues.rst.

However, this patch adds a third location, the NIC document. I have some
sympathy for this approach since the NIC docs generally have a limitations
section which is similar to known issues.

If we agree that this is a good approach then we should move all of the NIC
specific issues to the Limitations sections of the NIC docs and include a
section at the start of the "Known Issues" doc to remind users to also
check the NIC specific doc.

However, I think this needs to be co-ordinated and done in one go. So, for 
this release, let's not move the i40e known issues and instead do a general
cleanup and refactoring of the "Known Issues" at the very start of the 17.08
cycle.

Other opinions?

John

^ permalink raw reply	[flat|nested] 9+ messages in thread

* [dpdk-dev] [PATCH v2] doc: add known igb_uio issue for i40e
  2017-03-27  9:16 [dpdk-dev] [PATCH] doc: add known igb_uio issue for i40e Qiming Yang
  2017-03-30 12:08 ` Wu, Jingjing
  2017-04-03 10:40 ` Ferruh Yigit
@ 2017-04-13  3:08 ` Qiming Yang
  2017-04-14 16:03   ` Mcnamara, John
  2017-04-19  4:16   ` [dpdk-dev] [PATCH v3] " Qiming Yang
  2 siblings, 2 replies; 9+ messages in thread
From: Qiming Yang @ 2017-04-13  3:08 UTC (permalink / raw)
  To: dev; +Cc: jingjing.wu, john.mcnamara, Qiming Yang

When insmod "igb_uio" with "intr_mode=legacy and test link
status interrupt. Since INTx interrupt is not supported by
X710/XL710/XXV710, it will cause Input/Output error when
reading file descriptor.

Signed-off-by: Qiming Yang <qiming.yang@intel.com>
Acked-by Jingjing Wu <jingjing.wu@intel.com>
---
v2 changes:
* move the description to rel_notes/known_issues.rst
---
---
 doc/guides/rel_notes/known_issues.rst | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/doc/guides/rel_notes/known_issues.rst b/doc/guides/rel_notes/known_issues.rst
index f149ac7..61c2fa1 100644
--- a/doc/guides/rel_notes/known_issues.rst
+++ b/doc/guides/rel_notes/known_issues.rst
@@ -697,3 +697,27 @@ virtio tx_burst() function cannot do TSO on shared packets
 
 **Driver/Module**:
    Poll Mode Driver (PMD).
+
+
+igb uio legacy mode can not be used in X710/XL710/XXV710
+--------------------------------------------------------
+
+**Description**:
+   X710/XL710/XXV710 NICs lack support for indicating INTx is asserted via the interrupt
+   bit in the PCI status register. Linux delected them from INTx support table. The related
+   link `linux kernel commit <https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux-stable.git/commit/drivers/pci/quirks.c?id=8bcf4525c5d43306c5fd07e132bc8650e3491aec>`_.
+
+**Implication**:
+   When insmod ``igb_uio`` with ``intr_mode=legacy`` and test link status interrupt. Since
+   INTx interrupt is not supported by X710/XL710/XXV710, it will cause Input/Output error
+   when reading file descriptor.
+
+**Resolution/Workaround**:
+   Do not bind ``igb_uio`` with legacy mode in X710/XL710/XXV710 NICs, or do not use kernel
+   version >4.7 when you bind ``igb_uio`` with legacy mode.
+
+**Affected Environment/Platform**:
+   ALL.
+
+**Driver/Module**:
+   Poll Mode Driver (PMD).
-- 
2.7.4

^ permalink raw reply	[flat|nested] 9+ messages in thread

* Re: [dpdk-dev] [PATCH v2] doc: add known igb_uio issue for i40e
  2017-04-13  3:08 ` [dpdk-dev] [PATCH v2] " Qiming Yang
@ 2017-04-14 16:03   ` Mcnamara, John
  2017-04-14 16:53     ` Ferruh Yigit
  2017-04-19  4:16   ` [dpdk-dev] [PATCH v3] " Qiming Yang
  1 sibling, 1 reply; 9+ messages in thread
From: Mcnamara, John @ 2017-04-14 16:03 UTC (permalink / raw)
  To: Yang, Qiming, dev; +Cc: Wu, Jingjing



> -----Original Message-----
> From: Yang, Qiming
> Sent: Thursday, April 13, 2017 4:09 AM
> To: dev@dpdk.org
> Cc: Wu, Jingjing <jingjing.wu@intel.com>; Mcnamara, John
> <john.mcnamara@intel.com>; Yang, Qiming <qiming.yang@intel.com>
> Subject: [PATCH v2] doc: add known igb_uio issue for i40e
> 
> When insmod "igb_uio" with "intr_mode=legacy and test link status
> interrupt. Since INTx interrupt is not supported by X710/XL710/XXV710, it
> will cause Input/Output error when reading file descriptor.
> 
> Signed-off-by: Qiming Yang <qiming.yang@intel.com> Acked-by Jingjing Wu
> <jingjing.wu@intel.com>

Acked-by: John McNamara <john.mcnamara@intel.com>

^ permalink raw reply	[flat|nested] 9+ messages in thread

* Re: [dpdk-dev] [PATCH v2] doc: add known igb_uio issue for i40e
  2017-04-14 16:03   ` Mcnamara, John
@ 2017-04-14 16:53     ` Ferruh Yigit
  0 siblings, 0 replies; 9+ messages in thread
From: Ferruh Yigit @ 2017-04-14 16:53 UTC (permalink / raw)
  To: Mcnamara, John, Yang, Qiming, dev; +Cc: Wu, Jingjing

On 4/14/2017 5:03 PM, Mcnamara, John wrote:
> 
> 
>> -----Original Message-----
>> From: Yang, Qiming
>> Sent: Thursday, April 13, 2017 4:09 AM
>> To: dev@dpdk.org
>> Cc: Wu, Jingjing <jingjing.wu@intel.com>; Mcnamara, John
>> <john.mcnamara@intel.com>; Yang, Qiming <qiming.yang@intel.com>
>> Subject: [PATCH v2] doc: add known igb_uio issue for i40e
>>
>> When insmod "igb_uio" with "intr_mode=legacy and test link status
>> interrupt. Since INTx interrupt is not supported by X710/XL710/XXV710, it
>> will cause Input/Output error when reading file descriptor.
>>
>> Signed-off-by: Qiming Yang <qiming.yang@intel.com> Acked-by Jingjing Wu
>> <jingjing.wu@intel.com>
> 
> Acked-by: John McNamara <john.mcnamara@intel.com>

Applied to dpdk-next-net/master, thanks.

^ permalink raw reply	[flat|nested] 9+ messages in thread

* [dpdk-dev] [PATCH v3] doc: add known igb_uio issue for i40e
  2017-04-13  3:08 ` [dpdk-dev] [PATCH v2] " Qiming Yang
  2017-04-14 16:03   ` Mcnamara, John
@ 2017-04-19  4:16   ` Qiming Yang
  2017-04-19 10:06     ` Ferruh Yigit
  1 sibling, 1 reply; 9+ messages in thread
From: Qiming Yang @ 2017-04-19  4:16 UTC (permalink / raw)
  To: dev; +Cc: yigit.ferruh, Qiming Yang

When insmod "igb_uio" with "intr_mode=legacy and test link
status interrupt. Since INTx interrupt is not supported by
X710/XL710/XXV710, it will cause Input/Output error when
reading file descriptor.

Signed-off-by: Qiming Yang <qiming.yang@intel.com>
Acked-by Jingjing Wu <jingjing.wu@intel.com>
Acked-by: John McNamara <john.mcnamara@intel.com>
---
v2 changes:
* move the description to rel_notes/known_issues.rst
v3 changes:
* fixed a doc build warning
---
---
 doc/guides/rel_notes/known_issues.rst | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/doc/guides/rel_notes/known_issues.rst b/doc/guides/rel_notes/known_issues.rst
index f149ac7..a5592b0 100644
--- a/doc/guides/rel_notes/known_issues.rst
+++ b/doc/guides/rel_notes/known_issues.rst
@@ -697,3 +697,27 @@ virtio tx_burst() function cannot do TSO on shared packets
 
 **Driver/Module**:
    Poll Mode Driver (PMD).
+
+
+igb uio legacy mode can not be used in X710/XL710/XXV710
+--------------------------------------------------------
+
+**Description**:
+   X710/XL710/XXV710 NICs lack support for indicating INTx is asserted via the interrupt
+   bit in the PCI status register. Linux delected them from INTx support table. The related
+   link `<https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux-stable.git/commit/drivers/pci/quirks.c?id=8bcf4525c5d43306c5fd07e132bc8650e3491aec>`_.
+
+**Implication**:
+   When insmod ``igb_uio`` with ``intr_mode=legacy`` and test link status interrupt. Since
+   INTx interrupt is not supported by X710/XL710/XXV710, it will cause Input/Output error
+   when reading file descriptor.
+
+**Resolution/Workaround**:
+   Do not bind ``igb_uio`` with legacy mode in X710/XL710/XXV710 NICs, or do not use kernel
+   version >4.7 when you bind ``igb_uio`` with legacy mode.
+
+**Affected Environment/Platform**:
+   ALL.
+
+**Driver/Module**:
+   Poll Mode Driver (PMD).
-- 
2.4.11

^ permalink raw reply	[flat|nested] 9+ messages in thread

* Re: [dpdk-dev] [PATCH v3] doc: add known igb_uio issue for i40e
  2017-04-19  4:16   ` [dpdk-dev] [PATCH v3] " Qiming Yang
@ 2017-04-19 10:06     ` Ferruh Yigit
  0 siblings, 0 replies; 9+ messages in thread
From: Ferruh Yigit @ 2017-04-19 10:06 UTC (permalink / raw)
  To: Qiming Yang, dev; +Cc: yigit.ferruh

On 4/19/2017 5:16 AM, Qiming Yang wrote:
> When insmod "igb_uio" with "intr_mode=legacy and test link
> status interrupt. Since INTx interrupt is not supported by
> X710/XL710/XXV710, it will cause Input/Output error when
> reading file descriptor.
> 
> Signed-off-by: Qiming Yang <qiming.yang@intel.com>
> Acked-by Jingjing Wu <jingjing.wu@intel.com>
> Acked-by: John McNamara <john.mcnamara@intel.com>

Squashed into relevant commit in next-net, thanks.

Diff is only in link to fix doc build warning:
.../doc/guides/rel_notes/known_issues.rst:33:
WARNING: Duplicate explicit target name: "linux kernel commit".

^ permalink raw reply	[flat|nested] 9+ messages in thread

end of thread, other threads:[~2017-04-19 10:06 UTC | newest]

Thread overview: 9+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2017-03-27  9:16 [dpdk-dev] [PATCH] doc: add known igb_uio issue for i40e Qiming Yang
2017-03-30 12:08 ` Wu, Jingjing
2017-04-03 10:40 ` Ferruh Yigit
2017-04-03 13:30   ` Mcnamara, John
2017-04-13  3:08 ` [dpdk-dev] [PATCH v2] " Qiming Yang
2017-04-14 16:03   ` Mcnamara, John
2017-04-14 16:53     ` Ferruh Yigit
2017-04-19  4:16   ` [dpdk-dev] [PATCH v3] " Qiming Yang
2017-04-19 10:06     ` Ferruh Yigit

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).