From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga14.intel.com (mga14.intel.com [192.55.52.115]) by dpdk.org (Postfix) with ESMTP id 058815930 for ; Mon, 9 Feb 2015 14:13:54 +0100 (CET) Received: from orsmga001.jf.intel.com ([10.7.209.18]) by fmsmga103.fm.intel.com with ESMTP; 09 Feb 2015 05:06:55 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.09,544,1418112000"; d="scan'208";a="649471793" Received: from pgsmsx104.gar.corp.intel.com ([10.221.44.91]) by orsmga001.jf.intel.com with ESMTP; 09 Feb 2015 05:13:50 -0800 Received: from shsmsx103.ccr.corp.intel.com (10.239.4.69) by PGSMSX104.gar.corp.intel.com (10.221.44.91) with Microsoft SMTP Server (TLS) id 14.3.195.1; Mon, 9 Feb 2015 21:13:48 +0800 Received: from shsmsx101.ccr.corp.intel.com ([169.254.1.192]) by SHSMSX103.ccr.corp.intel.com ([169.254.4.197]) with mapi id 14.03.0195.001; Mon, 9 Feb 2015 21:13:47 +0800 From: "Qiu, Michael" To: "dts@dpdk.org" Thread-Topic: [PATCH] test_plan: add hotplug_test_plan Thread-Index: AQHQPsTXSPmZsjvrL02oMBr5A1mZQw== Date: Mon, 9 Feb 2015 13:13:47 +0000 Message-ID: <533710CFB86FA344BFBF2D6802E60286CE7206@SHSMSX101.ccr.corp.intel.com> References: <1422866813-23729-1-git-send-email-michael.qiu@intel.com> Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-originating-ip: [10.239.127.40] Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 Cc: "mukawa@igel.co.jp" , "Iremonger, Bernard" Subject: Re: [dts] [PATCH] test_plan: add hotplug_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: Mon, 09 Feb 2015 13:13:55 -0000 [+cc] Bernard=0A= =0A= Hi, Bernard and Tetsuya=0A= =0A= Would you have time to review this test plan?=0A= Your comments are very important.=0A= =0A= Thanks,=0A= Michael=0A= On 2/2/2015 4:47 PM, Qiu, Michael wrote:=0A= > As hotplug feature will be supported by DPDK 2.0, the test plan=0A= > is needed for testing affairs, this could help who wants to do=0A= > hotplug testing for their projects.=0A= >=0A= > Signed-off-by: Michael Qiu =0A= > ---=0A= > test_plans/hotplug_test_plan.rst | 152 +++++++++++++++++++++++++++++++++= ++++++=0A= > 1 file changed, 152 insertions(+)=0A= > create mode 100644 test_plans/hotplug_test_plan.rst=0A= >=0A= > diff --git a/test_plans/hotplug_test_plan.rst b/test_plans/hotplug_test_p= lan.rst=0A= > new file mode 100644=0A= > index 0000000..63c3d70=0A= > --- /dev/null=0A= > +++ b/test_plans/hotplug_test_plan.rst=0A= > @@ -0,0 +1,152 @@=0A= > +.. Copyright (c) <2015>, Intel Corporation=0A= > + All rights reserved.=0A= > +=0A= > + Redistribution and use in source and binary forms, with or without=0A= > + modification, are permitted provided that the following conditions=0A= > + are met:=0A= > +=0A= > + - Redistributions of source code must retain the above copyright=0A= > + notice, this list of conditions and the following disclaimer.=0A= > +=0A= > + - Redistributions in binary form must reproduce the above copyright= =0A= > + notice, this list of conditions and the following disclaimer in=0A= > + the documentation and/or other materials provided with the=0A= > + distribution.=0A= > +=0A= > + - Neither the name of Intel Corporation nor the names of its=0A= > + contributors may be used to endorse or promote products derived=0A= > + from this software without specific prior written permission.=0A= > +=0A= > + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS= =0A= > + "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT=0A= > + LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS=0A= > + FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE=0A= > + COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,= =0A= > + INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES=0A= > + (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR=0A= > + SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)=0A= > + HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,= =0A= > + STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)=0A= > + ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED= =0A= > + OF THE POSSIBILITY OF SUCH DAMAGE.=0A= > +=0A= > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=0A= > +DPDK Hotplug API Feature Tests=0A= > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=0A= > +=0A= > +This test for Hotplug API feature can be run on linux userspace. It=0A= > +will check if NIC port can be attach and detach without exiting the=0A= > +application process. Furthermore, it will check if it can reconfigure=0A= > +new configurations for a port after the port is stopped, and if it is=0A= > +able to restart with those new configurations. It is based on testpmd=0A= > +application.=0A= > +=0A= > +The test is performed by running the testpmd application and using a=0A= > +traffic generator. Port configurations can be set interactively,=0A= > +and still be set at the command line when launching the application in= =0A= > +order to be compatible with previous test framework.=0A= > +=0A= > +Prerequisites=0A= > +-------------=0A= > +Assume DPDK managerd at least one device for physical or none for virtua= l.=0A= > +This feature only supports igb_uio now, for uio_pci_generic is=0A= > +on the way, will test it after enabled.=0A= > +=0A= > +To run the testpmd application in linuxapp environment with 4 lcores,=0A= > +4 channels with other default parameters in interactive mode.=0A= > +=0A= > + $ ./testpmd -c 0xf -n 4 -- -i=0A= > +=0A= > +Test ENV:=0A= > +=0A= > +All test case can be run in 32bit and 64bit platform.=0A= > +=0A= > +All os can be support, like fedora, ubuntu, rhel, suse, but freebsd will= =0A= > +not include as hotplug has no plan to support that platform=0A= > +=0A= > +All kernel version(start from 2.6) can be support, for vfio need kernel= =0A= > + version greater than 3.6.=0A= > +=0A= > +Virtulization support: KVM/VMware/Xen, container is in the roadmap=0A= > +=0A= > +------------------------------------------------------------------------= -------=0A= > +Test Case 1: port dettach & attach for physical devices with igb_uio=0A= > +------------------------------------------------------------------------= -------=0A= > +1. run "port attach 0000:02:00.0",=0A= > + assume the physical devices is BDF is 0000:02:00.0=0A= > +=0A= > +2. run "port start 0".=0A= > +=0A= > +3. run "show port info 0", check port 0 info display.=0A= > +=0A= > +4. run "start", then "show port stats 0" check fwd packages start.=0A= > +=0A= > +5. run "port detach 0", check the error message of port not stopped.=0A= > +=0A= > +6. run "stop", then "show port stats 0", check fwd packages stoped.=0A= > +=0A= > +7. run "port close 0".=0A= > +=0A= > +8. run "port detach 0", check port detached successful.=0A= > +=0A= > +------------------------------------------------------------------------= -------=0A= > +Test Case 2: port dettach & attach for physical devices with vfio=0A= > +------------------------------------------------------------------------= -------=0A= > +1. run "port attach 0000:02:00.0",=0A= > + assume the physical devices is BDF is 0000:02:00.0=0A= > +=0A= > +2. run "port start 0".=0A= > +=0A= > +3. run "show port info 0", check port 0 info display.=0A= > +=0A= > +4. run "start", then "show port stats 0" check fwd packages start.=0A= > +=0A= > +5. run "port detach 0", check the error message of port not stopped.=0A= > +=0A= > +6. run "stop", then "show port stats 0", check fwd packages stoped.=0A= > +=0A= > +7. run "port close 0".=0A= > +=0A= > +8. run "port detach 0", check port detached failed(If hotplug for vfio= =0A= > + implemented, should be successful).=0A= > +=0A= > +------------------------------------------------------------------------= -------=0A= > +Test Case 3: port dettach & attach for physical devices with uio_pci_gen= eric=0A= > +------------------------------------------------------------------------= -------=0A= > +1. run "port attach 0000:02:00.0",=0A= > + assume the physical devices is BDF is 0000:02:00.0=0A= > +=0A= > +2. run "port start 0".=0A= > +=0A= > +3. run "show port info 0", check port 0 info display.=0A= > +=0A= > +4. run "start", then "show port stats 0" check fwd packages start.=0A= > +=0A= > +5. run "port detach 0", check the error message of port not stopped.=0A= > +=0A= > +6. run "stop", then "show port stats 0", check fwd packages stoped.=0A= > +=0A= > +7. run "port close 0".=0A= > +=0A= > +8. run "port detach 0", check port detached successful.=0A= > +=0A= > +------------------------------------------------------------------------= -------=0A= > +Test Case 4: port dettach & attach for virtual devices=0A= > +------------------------------------------------------------------------= -------=0A= > +1. run "port attach eth_pcap0,iface=3Dxxxx", where "xxxx" is one workabl= e ifname.=0A= > +=0A= > +2. run "port start 0".=0A= > +=0A= > +3. run "show port info 0", check port 0 info display.=0A= > +=0A= > +4. run "start", then "show port stats 0" check fwd packages start.=0A= > +=0A= > +5. run "port detach 0", check the error message of port not stopped.=0A= > +=0A= > +6. run "stop", then "show port stats 0", check fwd packages stoped.=0A= > +=0A= > +7. run "port close 0".=0A= > +=0A= > +8. run "port detach 0", check port detached successful.=0A= > +=0A= > +successfully =0A= =0A=