[dpdk-dev,v2,4/4] doc: add switch restart support to fm10k guide

Message ID 1508852752-127925-5-git-send-email-xiao.w.wang@intel.com (mailing list archive)
State Accepted, archived
Delegated to: Ferruh Yigit
Headers

Checks

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

Commit Message

Xiao Wang Oct. 24, 2017, 1:45 p.m. UTC
  This patch documents how DPDK app should handle the event of switch
quit-restart to resume its network without an app-level restart.

Signed-off-by: Xiao Wang <xiao.w.wang@intel.com>
---
v2:
- Improve the wording.
---
 doc/guides/nics/fm10k.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)
  

Comments

John McNamara Oct. 24, 2017, 10:56 a.m. UTC | #1
> -----Original Message-----
> From: Wang, Xiao W
> Sent: Tuesday, October 24, 2017 2:46 PM
> To: Wu, Jingjing <jingjing.wu@intel.com>
> Cc: dev@dpdk.org; Mcnamara, John <john.mcnamara@intel.com>; Zhang, Qi Z
> <qi.z.zhang@intel.com>; Wang, Xiao W <xiao.w.wang@intel.com>
> Subject: [PATCH v2 4/4] doc: add switch restart support to fm10k guide
> 
> This patch documents how DPDK app should handle the event of switch quit-
> restart to resume its network without an app-level restart.
> 
> Signed-off-by: Xiao Wang <xiao.w.wang@intel.com>

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

Patch

diff --git a/doc/guides/nics/fm10k.rst b/doc/guides/nics/fm10k.rst
index 7fc4862..b47fc0d 100644
--- a/doc/guides/nics/fm10k.rst
+++ b/doc/guides/nics/fm10k.rst
@@ -161,6 +161,17 @@  FM10000 PMD driver. The switch driver can be acquired from Intel support.
 Only Testpoint is validated with DPDK, the latest version that has been
 validated with DPDK is 4.1.6.
 
+Support for Switch Restart
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+For FM10000 multi host based design a DPDK app running in the VM or host needs
+to be aware of the switch's state since it may undergo a quit-restart. When
+the switch goes down the DPDK app will receive a LSC event indicating link
+status down, and the app should stop the worker threads that are polling on
+the Rx/Tx queues. When switch comes up, a LSC event indicating ``LINK_UP`` is
+sent to the app, which can then restart the FM10000 port to resume network
+processing.
+
 CRC striping
 ~~~~~~~~~~~~