From a2e97ef700f396fa086c72f24be331599cfed401 Mon Sep 17 00:00:00 2001 From: Jeff Guo Date: Tue, 20 Nov 2018 23:09:31 +0800 Subject: [PATCH] doc: add known issue when hot-unplug igb_uio device When device has been bound to igb_uio driver and application is running, hot-unplugging the device may cause kernel crash. Signed-off-by: Jeff Guo Reviewed-by: Ferruh Yigit Acked-by: John McNamara --- doc/guides/rel_notes/known_issues.rst | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/doc/guides/rel_notes/known_issues.rst b/doc/guides/rel_notes/known_issues.rst index a2c7d3df83..a1face9c1d 100644 --- a/doc/guides/rel_notes/known_issues.rst +++ b/doc/guides/rel_notes/known_issues.rst @@ -805,3 +805,24 @@ Restricted vdev ethdev operations supported in secondary process **Driver/Module**: Virtual Device Poll Mode Driver (PMD). + + +Kernel crash when hot-unplug igb_uio device while DPDK application is running +----------------------------------------------------------------------------- + +**Description**: + When device has been bound to igb_uio driver and application is running, + hot-unplugging the device may cause kernel crash. + +**Reason**: + When device is hot-unplugged, igb_uio driver will be removed which will destroy UIO resources. + Later trying to access any uio resource will cause kernel crash. + +**Resolution/Workaround**: + If using DPDK for PCI HW hot-unplug, prefer to bind device with VFIO instead of IGB_UIO. + +**Affected Environment/Platform**: + ALL. + +**Driver/Module**: + ``igb_uio`` module. -- 2.20.1