diff mbox series

[V3] doc: add known PHY link up issue for i40e

Message ID 1542335898-148573-1-git-send-email-jia.guo@intel.com (mailing list archive)
State Accepted, archived
Delegated to: Qi Zhang
Headers
Series [V3] doc: add known PHY link up issue for i40e |

Checks

Context Check Description
ci/checkpatch success coding style OK
ci/Intel-compilation success Compilation OK
ci/mellanox-Performance-Testing success Performance Testing PASS
ci/intel-Performance-Testing success Performance Testing PASS

Commit Message

Guo, Jia Nov. 16, 2018, 2:38 a.m. UTC 
  Some kernel drivers are not able to handle the link status correctly
after DPDK application sets the PHY to link down.

Signed-off-by: Jeff Guo <jia.guo@intel.com>
---
 doc/guides/rel_notes/known_issues.rst | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

Comments

Kovacevic, Marko Nov. 16, 2018, 9:41 a.m. UTC | #1 
One very small spelling fix 

> +PHY link up fails when rebinding i40e NICs to kernel driver
> +-----------------------------------------------------------
> +
> +**Description**:
> +   Some kernel drivers are not able to handle the link status correctly
> +   after DPDK application sets the PHY to link down.
> +
> +**Implication**:
> +   The link status can't be set to "up" after the NIC is rebound to the
> +   kernel driver. Before a DPDK application quits it will invokes the

Invokes/ invoke


Everything else looks fine to me.

You can add my ack in the next quick fix.

Acked-by: Marko Kovacevic <marko.kovacevic@intel.com>
Qi Zhang Nov. 16, 2018, 7:32 p.m. UTC | #2 
> -----Original Message-----
> From: Kovacevic, Marko
> Sent: Friday, November 16, 2018 1:41 AM
> To: Guo, Jia <jia.guo@intel.com>; Xing, Beilei <beilei.xing@intel.com>;
> Mcnamara, John <john.mcnamara@intel.com>; Zhang, Qi Z
> <qi.z.zhang@intel.com>
> Cc: dev@dpdk.org; Zhang, Helin <helin.zhang@intel.com>; Wu, Jingjing
> <jingjing.wu@intel.com>
> Subject: RE: [PATCH V3] doc: add known PHY link up issue for i40e
> 
> One very small spelling fix
> 
> > +PHY link up fails when rebinding i40e NICs to kernel driver
> > +-----------------------------------------------------------
> > +
> > +**Description**:
> > +   Some kernel drivers are not able to handle the link status correctly
> > +   after DPDK application sets the PHY to link down.
> > +
> > +**Implication**:
> > +   The link status can't be set to "up" after the NIC is rebound to the
> > +   kernel driver. Before a DPDK application quits it will invokes the
> 
> Invokes/ invoke
> 
> 
> Everything else looks fine to me.
> 
> You can add my ack in the next quick fix.
> 
> Acked-by: Marko Kovacevic <marko.kovacevic@intel.com>

Applied to dpdk-next-net-intel with the typo fix.

Thanks
Qi
diff mbox series

Patch

diff --git a/doc/guides/rel_notes/known_issues.rst b/doc/guides/rel_notes/known_issues.rst
index 95e4ce6..03fe163 100644
--- a/doc/guides/rel_notes/known_issues.rst
+++ b/doc/guides/rel_notes/known_issues.rst
@@ -759,3 +759,31 @@  Netvsc driver and application restart
 
 **Driver/Module**:
    ``uio_hv_generic`` module.
+
+
+PHY link up fails when rebinding i40e NICs to kernel driver
+-----------------------------------------------------------
+
+**Description**:
+   Some kernel drivers are not able to handle the link status correctly
+   after DPDK application sets the PHY to link down.
+
+**Implication**:
+   The link status can't be set to "up" after the NIC is rebound to the
+   kernel driver. Before a DPDK application quits it will invokes the
+   function ``i40e_dev_stop()`` which will sets the PHY to link down. Some
+   kernel drivers may not be able to handle the link status correctly after
+   it retakes control of the device. This is a known PHY link configuration
+   issue in the i40e kernel driver. The fix has been addressed in the 2.7.4 rc
+   version. So if the i40e kernel driver is < 2.7.4 and doesn't have the
+   fix backported it will encounter this issue.
+
+**Resolution/Workaround**:
+   First try to remove and reinsert the i40e kernel driver. If that fails
+   reboot the system.
+
+**Affected Environment/Platform**:
+   All.
+
+**Driver/Module**:
+   Poll Mode Driver (PMD).