From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga04.intel.com (mga04.intel.com [192.55.52.120]) by dpdk.org (Postfix) with ESMTP id 459615F36 for ; Tue, 27 Nov 2018 12:31:06 +0100 (CET) X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from orsmga001.jf.intel.com ([10.7.209.18]) by fmsmga104.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 27 Nov 2018 03:31:05 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.56,286,1539673200"; d="scan'208";a="112212808" Received: from dpdk-test60.sh.intel.com ([10.67.111.98]) by orsmga001.jf.intel.com with ESMTP; 27 Nov 2018 03:31:04 -0800 From: Xueqin Lin To: dts@dpdk.org Cc: "xueqin.lin" Date: Tue, 27 Nov 2018 00:30:05 -0500 Message-Id: <1543296605-36380-1-git-send-email-xueqin.lin@intel.com> X-Mailer: git-send-email 2.5.5 Subject: [dts] [PATCH] test_plans: add hotplug on multi-processes test plan X-BeenThere: dts@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: test suite reviews and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 27 Nov 2018 11:31:06 -0000 From: "xueqin.lin" Signed-off-by: Xueqin Lin --- test_plans/hotplug_mp_test_plan.rst | 229 ++++++++++++++++++++++++++++++++++++ 1 file changed, 229 insertions(+) create mode 100755 test_plans/hotplug_mp_test_plan.rst diff --git a/test_plans/hotplug_mp_test_plan.rst b/test_plans/hotplug_mp_test_plan.rst new file mode 100755 index 0000000..4b9c6dd --- /dev/null +++ b/test_plans/hotplug_mp_test_plan.rst @@ -0,0 +1,229 @@ +.. Copyright (c) <2018>, Intel Corporation + All rights reserved. + + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions + are met: + + - Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + + - Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in + the documentation and/or other materials provided with the + distribution. + + - Neither the name of Intel Corporation nor the names of its + contributors may be used to endorse or promote products derived + from this software without specific prior written permission. + + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS + FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE + COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, + INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES + (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR + SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, + STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) + ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED + OF THE POSSIBILITY OF SUCH DAMAGE. + +========================== +Hotplug on multi-processes +========================== +Currently secondary process will only sync ethdev from primary +process at init stage, but it will not be aware if device +is attached/detached on primary process at runtime. + +While there is the requirement from application that take +primary-secondary process model. The primary process work as a +resource management process, it will create/destroy virtual device +at runtime, while the secondary process deal with the network stuff +with these devices. + +So the orignial intention is to fix this gap, but beyond that +the patch set provide a more comprehesive solution to handle +different hotplug cases in multi-process situation, it cover below +scenario: + + Attach a device from the primary + Detach a device from the primary + Attach a device from a secondary + Detach a device from a secondary + +In primary-secondary process model, we assume ethernet devices are +shared by default, that means attach or detach a device on any process will +broadcast to all other processes through mp channel then device information +will be synchronized on all processes. + +Any failure during attaching process will cause inconsistent status +between processes, so proper rollback action should be considered. + + +Test Case: Attach physical device from primary or secondary +=========================================================== +Start sample code as primary then secondary:: + ./hotplug_mp --proc-type=auto + +Check primary and secondary processes don't have any device:: + example> list + list all etherdev + +Bind one port to igb_uio or vfio + +Attach the physical device from primary or secondary, check primary and +secondary processes attach the share device successfully:: + + example> attach 0000:88:00.0 + example> list + list all etherdev + 0 0000:88:00.0 + +Quit primary and secondary processes + +Re-bind port to kernel state + + +Test Case: Detach physical device from primary or secondary +=========================================================== +Bind one port to igb_uio or vfio + +Start sample code as primary then secondary:: + ./hotplug_mp --proc-type=auto + +Check primary and secondary processes have the device:: + example> list + list all etherdev + 0 0000:88:00.0 + +Detach the physical device from primary or secondary, check primary and +secondary processes detach the share device successfully:: + + example> detach 0000:88:00.0 + example> list + list all etherdev + +Quit primary and secondary processes + +Re-bind port to kernel state + + +Test Case: Attach virtual device from primary or secondary +========================================================== +Start sample code as primary then secondary:: + ./hotplug_mp --proc-type=auto + +Check primary and secondary processes don't have any device:: + example> list + list all etherdev + +Attach a virtual device from primary or secondary, check primary and +secondary processes attach the share device successfully:: + + example> attach net_af_packet,iface=ens803f1 + example> list + list all etherdev + 0 net_af_packet + +Quit primary and secondary processes + +Test Case: Detach virtual device from primary or secondary +========================================================== +Start sample code as primary then secondary:: + ./hotplug_mp --proc-type=auto + +Check primary and secondary processes don't have any device:: + example> list + list all etherdev + +Attach a virtual device from primary or secondary, check primary and +secondary processes attach the share device successfully:: + + example> attach net_af_packet,iface=ens803f1 + example> list + list all etherdev + 0 net_af_packet + +Detach the physical device from primary or secondary, check primary and +secondary processes detach the share device successfully:: + + example> detach net_af_packet + example> list + list all etherdev + +Quit primary and secondary processes + +Test Case: Repeat to attach/detach physical device from primary or secondary +============================================================================ +Start sample code as primary then secondary:: + ./hotplug_mp --proc-type=auto + +Check primary and secondary processes don't have any device:: + example> list + list all etherdev + +Bind one port to igb_uio or vfio + +Attach the physical device from primary or secondary, check primary and +secondary processes attach the share device successfully:: + + example> attach 0000:88:00.0 + example> list + list all etherdev + 0 0000:88:00.0 + +Attach the same physical device from primary or secondary, check primary and +secondary processes fail to attach same device again + +Detach the physical device from primary or secondary, check primary and +secondary processes detach the share device successfully:: + + example> detach 0000:88:00.0 + example> list + list all etherdev + +Detach the same physical device from primary or secondary, check primary and +secondary processes fail to detach same device again + +Repeat above attach and detach for 2 times + +Quit primary and secondary processes + +Re-bind port to kernel state + + +Test Case: Repeat to attach/detach virtual device from primary or secondary +=========================================================================== +Start sample code as primary then secondary:: + ./hotplug_mp --proc-type=auto + +Check primary and secondary processes don't have any device:: + example> list + list all etherdev + +Attach a virtual device from primary or secondary, check primary and +secondary processes attach the share device successfully:: + + example> attach net_af_packet,iface=ens803f1 + example> list + list all etherdev + 0 net_af_packet + +Attach the same virtual device from primary or secondary, check primary and +secondary processes fail to attach same device again + +Detach the virtual device from primary or secondary, check primary and +secondary processes detach the share device successfully:: + + example> detach net_af_packet + example> list + list all etherdev + +Detach the same virtual device from primary or secondary, check primary and +secondary processes fail to detach same device again + +Repeat above attach and detach for 2 times + +Quit primary and secondary processes -- 2.7.5