aboutsummaryrefslogtreecommitdiffstats
path: root/host/docs/dpdk.dox
diff options
context:
space:
mode:
authorAaron Rossetto <aaron.rossetto@ni.com>2020-09-03 08:59:28 -0500
committerAaron Rossetto <aaron.rossetto@ni.com>2020-09-03 15:01:12 -0500
commit6024111d4b8b60d02c17d968aca4c767f4e07569 (patch)
treed9beb07d161ddd9174c434f02c4e076520fb6a15 /host/docs/dpdk.dox
parenteada49e4d5a341e0af56c39585a90f63380fb5f8 (diff)
downloaduhd-6024111d4b8b60d02c17d968aca4c767f4e07569.tar.gz
uhd-6024111d4b8b60d02c17d968aca4c767f4e07569.tar.bz2
uhd-6024111d4b8b60d02c17d968aca4c767f4e07569.zip
docs: Add DPDK link detection section
Diffstat (limited to 'host/docs/dpdk.dox')
-rw-r--r--host/docs/dpdk.dox18
1 files changed, 17 insertions, 1 deletions
diff --git a/host/docs/dpdk.dox b/host/docs/dpdk.dox
index 3f71231a5..e77db24a2 100644
--- a/host/docs/dpdk.dox
+++ b/host/docs/dpdk.dox
@@ -85,7 +85,7 @@ might be
If successful, the script might provide an updated status like this:
/usr/share/dpdk/usertools/dpdk-devbind.py -s
-
+
Network devices using DPDK-compatible driver
============================================
0000:02:00.0 '82599ES 10-Gigabit SFI/SFP+ Network Connection 10fb' drv=vfio-pci unused=ixgbe
@@ -186,5 +186,21 @@ runtime. There is no mechanism for MPM's TCP/IP control traffic to flow over a
link that is occupied by DPDK, so mgmt_addr must point to a link that is not
used for CHDR, such as N310's RJ45 port.
+\subsection dpdk_link_detection DPDK Link Detection
+
+When DPDK is enabled and the driver is initializing, the status of all
+DPDK-enabled links is checked to verify that all links are active before the
+driver proceeds. The links are checked every 250 ms until all links have
+reported that they are up or until the link timeout expires, which by default
+is 1000 ms. If any of the links have not reported as being up by the time the
+timeout expires, a runtime error is thrown.
+
+Users may choose to override the link timeout in cases where particular
+systems and/or network cards take longer to establish stable DPDK links.
+The timeout can be overridden by passing `dpdk_link_timeout=N` in the device
+arguments, where N is the desired timeout time in <b>milliseconds</b>, or
+by adding a `dpdk_link_timeout` entry to the
+\ref page_configfiles "UHD configuration file".
+
*/
// vim:ft=doxygen: