[dpdk-dev,v2] doc: relocate i40e known issues

Message ID 1490668136-46758-1-git-send-email-qiming.yang@intel.com (mailing list archive)
State Changes Requested, archived
Delegated to: Ferruh Yigit
Headers

Checks

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

Commit Message

Qiming Yang March 28, 2017, 2:28 a.m. UTC
  This patch moved i40e related known issues from doc/guides/rel_notes/
known_issues.rst to doc/guides/nics/i40e.rst, makes us easy
to track the issue about i40e.

Signed-off-by: Qiming Yang <qiming.yang@intel.com>
---
 doc/guides/nics/i40e.rst              | 26 ++++++++++++++
 doc/guides/rel_notes/known_issues.rst | 65 -----------------------------------
 2 files changed, 26 insertions(+), 65 deletions(-)
  

Comments

Jingjing Wu March 30, 2017, 12:06 p.m. UTC | #1
> -----Original Message-----

> From: Yang, Qiming

> Sent: Tuesday, March 28, 2017 10:29 AM

> To: dev@dpdk.org

> Cc: Wu, Jingjing <jingjing.wu@intel.com>; Mcnamara, John

> <john.mcnamara@intel.com>; Lu, Wenzhuo <wenzhuo.lu@intel.com>; Yang,

> Qiming <qiming.yang@intel.com>

> Subject: [PATCH v2] doc: relocate i40e known issues

> 

> This patch moved i40e related known issues from doc/guides/rel_notes/

> known_issues.rst to doc/guides/nics/i40e.rst, makes us easy to track the issue

> about i40e.

> 

> Signed-off-by: Qiming Yang <qiming.yang@intel.com>

Acked-by Jingjing Wu <jingjing.wu@intel.com>
  
Ferruh Yigit April 13, 2017, 10:13 a.m. UTC | #2
On 3/28/2017 3:28 AM, Qiming Yang wrote:
> This patch moved i40e related known issues from doc/guides/rel_notes/
> known_issues.rst to doc/guides/nics/i40e.rst, makes us easy
> to track the issue about i40e.
> 
> Signed-off-by: Qiming Yang <qiming.yang@intel.com>
> ---
>  doc/guides/nics/i40e.rst              | 26 ++++++++++++++
>  doc/guides/rel_notes/known_issues.rst | 65 -----------------------------------

Instead of moving from "known_issues.rst" to "i40e.rst",

does it make sense to create a sub-section in "known_issues.rst" for
I40E and move these items under that sub-section,
and give a link in "i40e.rst" to that section?
  
Qiming Yang April 18, 2017, 5:48 a.m. UTC | #3
Hi, Ferruh
It's a good way, I'll send a new patch. Thank you.

Qiming
> -----Original Message-----

> From: Yigit, Ferruh

> Sent: Thursday, April 13, 2017 6:14 PM

> To: Yang, Qiming <qiming.yang@intel.com>; dev@dpdk.org

> Cc: Wu, Jingjing <jingjing.wu@intel.com>; Mcnamara, John

> <john.mcnamara@intel.com>; Lu, Wenzhuo <wenzhuo.lu@intel.com>

> Subject: Re: [dpdk-dev] [PATCH v2] doc: relocate i40e known issues

> 

> On 3/28/2017 3:28 AM, Qiming Yang wrote:

> > This patch moved i40e related known issues from doc/guides/rel_notes/

> > known_issues.rst to doc/guides/nics/i40e.rst, makes us easy to track

> > the issue about i40e.

> >

> > Signed-off-by: Qiming Yang <qiming.yang@intel.com>

> > ---

> >  doc/guides/nics/i40e.rst              | 26 ++++++++++++++

> >  doc/guides/rel_notes/known_issues.rst | 65

> > -----------------------------------

> 

> Instead of moving from "known_issues.rst" to "i40e.rst",

> 

> does it make sense to create a sub-section in "known_issues.rst" for I40E and

> move these items under that sub-section, and give a link in "i40e.rst" to that

> section?
  

Patch

diff --git a/doc/guides/nics/i40e.rst b/doc/guides/nics/i40e.rst
index 043de34..9d31565 100644
--- a/doc/guides/nics/i40e.rst
+++ b/doc/guides/nics/i40e.rst
@@ -417,6 +417,32 @@  or greater.
 Limitations or Known issues
 ---------------------------
 
+Cannot set link speed on Intel® 40G Ethernet controller
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+On Intel® 40G Ethernet Controller you cannot set the link to specific
+speed. The link speed cannot be changed forcibly, though it can be
+configured by application.
+
+I40e VF may not receive packets in the promiscuous mode
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Promiscuous mode is not supported by the DPDK i40e VF driver when using
+the i40e Linux kernel driver as host driver. The i40e VF does not receive
+packets when the destination MAC address is unknown. Use a explicit
+destination MAC address that matches the VF can avoid this problem.
+
+uio pci generic module bind failed in X710/XL710/XXV710
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+When use ``--bind=uio_pci_generic``, the ``uio_pci_generic`` module probes
+device and check the Interrupt Status bit. Since it is not supported by
+X710/XL710/XXV710, it return a *failed* value. The statement that these
+products don’t support INTx masking, is indicated in the related `linux kernel
+commit <https://git.kernel.org/cgit/linux/kernel/git/stable/linux-stable.git/
+commit/drivers/pci/quirks.c?id=8bcf4525c5d43306c5fd07e132bc8650e3491aec>`_.
+Do not bind the ``uio_pci_generic`` module in X710/XL710/XXV710 NICs.
+
 MPLS packet classification on X710/XL710
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/doc/guides/rel_notes/known_issues.rst b/doc/guides/rel_notes/known_issues.rst
index f149ac7..5b702c5 100644
--- a/doc/guides/rel_notes/known_issues.rst
+++ b/doc/guides/rel_notes/known_issues.rst
@@ -513,25 +513,6 @@  Ethertype filter could receive other packets (non-assigned) in Niantic
    Poll Mode Driver (PMD).
 
 
-Cannot set link speed on Intel® 40G Ethernet controller
--------------------------------------------------------
-
-**Description**:
-   On Intel® 40G Ethernet Controller you cannot set the link to specific speed.
-
-**Implication**:
-   The link speed cannot be changed forcibly, though it can be configured by application.
-
-**Resolution/Workaround**:
-   None
-
-**Affected Environment/Platform**:
-   All.
-
-**Driver/Module**:
-   Poll Mode Driver (PMD).
-
-
 Devices bound to igb_uio with VT-d enabled do not work on Linux kernel 3.15-3.17
 --------------------------------------------------------------------------------
 
@@ -622,52 +603,6 @@  The last EAL argument is replaced by the program name in argv[]
    Environment Abstraction Layer (EAL).
 
 
-I40e VF may not receive packets in the promiscuous mode
--------------------------------------------------------
-
-**Description**:
-   Promiscuous mode is not supported by the DPDK i40e VF driver when using the
-   i40e Linux kernel driver as host driver.
-
-**Implication**:
-   The i40e VF does not receive packets when the destination MAC address is unknown.
-
-**Resolution/Workaround**:
-   Use a explicit destination MAC address that matches the VF.
-
-**Affected Environment/Platform**:
-   All.
-
-**Driver/Module**:
-   Poll Mode Driver (PMD).
-
-
-uio pci generic module bind failed in X710/XL710/XXV710
--------------------------------------------------------
-
-**Description**:
-   The ``uio_pci_generic`` module is not supported by XL710, since the errata of XL710
-   states that the Interrupt Status bit is not implemented. The errata is the item #71
-   from the `xl710 controller spec
-   <http://www.intel.com/content/www/us/en/embedded/products/networking/xl710-10-40-controller-spec-update.html>`_.
-   The hw limitation is the same as other X710/XXV710 NICs.
-
-**Implication**:
-   When use ``--bind=uio_pci_generic``, the ``uio_pci_generic`` module probes device and check the Interrupt
-   Status bit. Since it is not supported by X710/XL710/XXV710, it return a *failed* value. The statement
-   that these products don’t support INTx masking, is indicated in the related `linux kernel commit
-   <https://git.kernel.org/cgit/linux/kernel/git/stable/linux-stable.git/commit/drivers/pci/quirks.c?id=8bcf4525c5d43306c5fd07e132bc8650e3491aec>`_.
-
-**Resolution/Workaround**:
-   Do not bind the ``uio_pci_generic`` module in X710/XL710/XXV710 NICs.
-
-**Affected Environment/Platform**:
-   All.
-
-**Driver/Module**:
-   Poll Mode Driver (PMD).
-
-
 virtio tx_burst() function cannot do TSO on shared packets
 ----------------------------------------------------------