[prev in list] [next in list] [prev in thread] [next in thread] 

List:       dpdk-dts
Subject:    Re: [dts] [PATCH V1 1/2] Packet capture: upload automation test plan
From:       "Mo, YufengX" <yufengx.mo () intel ! com>
Date:       2017-01-16 5:34:20
Message-ID: B8B15C44A3F2C044966E545C7B73711539FB73D7 () shsmsx102 ! ccr ! corp ! intel ! com
[Download RAW message or body]

hi, Marvin



see below.



> -----Original Message-----

> From: Liu, Yong

> Sent: January 16, 2017 11:08 AM

> To: Mo, YufengX; dts@dpdk.org

> Cc: Mo, YufengX

> Subject: RE: [dts] [PATCH V1 1/2] Packet capture: upload automation test plan

> 

> Yufen,

> Please make sure all lines in test plan and commit are limited to 79 characters.

> And some comments and questions below.

> 

> Thanks,

> Marvin

> 

> > -----Original Message-----

> > From: dts [mailto:dts-bounces@dpdk.org] On Behalf Of yufengx.mo@intel.com

> > Sent: Monday, January 16, 2017 10:49 AM

> > To: dts@dpdk.org

> > Cc: Mo, YufengX <yufengx.mo@intel.com>

> > Subject: [dts] [PATCH V1 1/2] Packet capture: upload automation test plan

> > 

> > From: yufengmx <yufengx.mo@intel.com>

> > 

> > 

> > Packet capture framework feature support packet capturing on dpdk ethernet

> > devices.

> > DPDK provides dpdk-pdump tool under app/pdump directory for packet

> > capturing on dpdk.

> > 

> > The  tool is a Data Plane Development Kit (DPDK) tool that runs as a DPDK

> > secondary process and is capable of enabling packet capture on dpdk ports.

> > * The  tool depends on libpcap based PMD which is disabled

> > by default in the build configuration files,

> > owing to an external dependency on the libpcap development files

> > which must be installed on the board.

> > Once the libpcap development files are installed, the libpcap based PMD

> > can be enabled by setting CONFIG_RTE_LIBRTE_PMD_PCAP=y and

> > recompiling the DPDK.

> > 

> > Signed-off-by: yufengmx <yufengx.mo@intel.com>

> > ---

> > test_plans/packet_capture_test_plan.rst | 376

> > ++++++++++++++++++++++++++++++++

> > 1 file changed, 376 insertions(+)

> > create mode 100644 test_plans/packet_capture_test_plan.rst

> > 

> > diff --git a/test_plans/packet_capture_test_plan.rst

> > b/test_plans/packet_capture_test_plan.rst

> > new file mode 100644

> > index 0000000..6a51cf9

> > --- /dev/null

> > +++ b/test_plans/packet_capture_test_plan.rst

> > @@ -0,0 +1,376 @@

> > +.. Copyright (c) <2016> 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.

> > +

> > +==================

> > +  packet capture framework feature

> > +==================

> > +

> > +Packet capture framework feature support packet capturing on dpdk ethernet

> > devices.

> > +DPDK provides dpdk-pdump tool under app/pdump directory for packet

> > capturing on dpdk.

> > +

> > +The dpdk-pdump application will act as the secondary process. The EAL

> > +thread polls for packet capture fd. If fd polled matches packet capture

> > +fd, it will initiate packet capture processing.

> > +

> > +The testpmd application will act as the primary process. The primary

> > +process create socket for packet capture connection with the secondary

> > +process and registers socket with packet capture epoll event. Packet capture

> > event will be polled as part of interrupt thread.

> > +

> > +The primary process creates mempool and two rte_rings for packets

> > +duplication and sharing packet info with the secondary process respectively.

> > +

> > +Upon receiving packet capture event, the primary process receive either

> > +register RX/TX callbacks or remove RX/TX callbacks message from the

> > +secondary process on socket.If packet matches, reference count of

> > +packet will be incremented and enqueued to second rte_ring for the secondary

> > process to use.

> > +

> > +Prerequisites

> > +=============

> > +* 2x NICs (2 full duplex ports per NIC) plugged into the available

> > +slots on a platform, another two nic ports are linked with cables.

> > +

> > +Test cases

> > +=============

> > +The testpmd application act as server process with port-topology

> > +chained mode, the dpdk-pdump act as client process to dump capture

> > +packet with different options setting. Select one port of tester as tx

> > +port, another port of tester as rx port, send different type packets

> > +from two ports, check pcap files' content dumped by scapy and tcpdump to

> > confirm testpmd working correctly, check pcap files' content dumped by

> > tcpdump and dpdk-pdump to confirm dpdk-pdump working correctly.

> > +

> > +dpdk-pdump command format

> > +--------------------------

> > +* packet capture framework tool dpdk-pdump command format, parameters

> > +inside the parenthesis represents the mandatory parametersm parameters

> 

> Typo issue, "parametersm" should be ?

> 

> > +inside the square brackets represents optional

> > +parameters::

> > +./x86_64-native-linuxapp-gcc/app/dpdk-pdump -- --pdump= '(port =

> > +<port_id> |device_id = <pci address>), (queue=<queue number>),

> > +(rx-dev=<iface/path to pcap file> | tx-dev=<iface/path to pcap file>),

> > +[ring-size=<size>], [mbuf-size=<size>], [total-num-mbufs=<size>]'

> > +

> > +transmission packets' format

> > +--------------------------

> > +* IP_RAW

> > +  [Ether()/IP()/Raw('\0'*60)]

> > +* TCP

> > +  [Ether()/IP()/TCP()/Raw('\0'*60)]

> > +* UDP

> > +  [Ether()/IP()/UDP()/Raw('\0'*60)]

> > +* SCTP

> > +  [Ether()/IP()/SCTP()/Raw('\0'*40)]

> > +* IPv6_TCP

> > +  [Ether()/IPv6()/TCP()/Raw('\0'*60)]

> > +* IPv6_UDP

> > +  [Ether()/IPv6()/UDP()/Raw('\0'*60)]

> > +* IPv6_SCTP

> > +  [Ether()/IP()/IPv6()/SCTP()/Raw('\0'*40)]

> > +* VLAN_UDP

> > +  [Ether()/Dot1Q()/IP()/UDP()/Raw('\0'*40)]

> > +* TIMESYNC

> > +  [Ether(dst='FF:FF:FF:FF:FF:FF',type=0x88f7)/"\\x00\\x02"]

> > +* ARP

> > +  [Ether(dst='FF:FF:FF:FF:FF:FF')/ARP()]

> > +* LLDP

> > +  [Ether()/LLDP()/LLDPManagementAddress()]

> > +  notice: LLDP()/LLDPManagementAddress() method are in dts/dep/lldp.py

> > +

> > +port configuration

> > +--------------------------

> > +* confirm two NICs physical link on a platform:

> > +  dut port 0 <---> tester port 0

> > +  dut port 1 <---> tester port 1

> > +

> > +* Bind two port on DUT::

> > + ./tools/dpdk_nic_bind.py --bind=igb_uio <dut port 0 pci address> <dut

> > +port 1 pci address>

> > +

> Tools folder has been changed to usertools.

> 

> > +* On dut, use port 0 as rx/tx port.

> > +  If dut port 0 rx dump is set, scapy send packet from tester port 0

> > +and tcpdump dumps tester

> > +  port 1's packet.

> > +

> > +  If dut port 0 tx dump is set, scapy send packet from tester port 1

> > + and tcpdump dumps tester  port 0's packet.

> > +

> > +* If using interfaces as dpdk-pdump vdev, prepare two ports on DUT,

> > +which haven't been binded

> > +  to dpdk and have been in linked status

> > +

> > +Test Case 1: test pdump port

> > +=================================

> > +test different port options::

> > +* port=<dut port id>

> > +* device_id=<dut pci address>

> > +

> > +Boot up dpdk's testpmd with chained option::

> > +      ./x86_64-native-linuxapp-gcc/app/testpmd -c 0x6 -n 4 -- -i --port-

> > topology=chained

> > +      testpmd> set fwd io

> > +      testpmd> start

> > +

> Recommend to remove targets which will be change between executions.

> 

> > +When test VLAN_UDP type packet transmission, set vlan:

> > +    testpmd> vlan set filter off 1

> > +    testpmd> start

> > +

> > +Boot up dpdk-pdump::

> > +    ./x86_64-native-linuxapp-gcc/app/dpdk-pdump -- --pdump  '<port

> > option>,queue=*,\

> > +    tx-dev=/tmp/pdump-tx.pcap,rx-dev=/tmp/pdump-rx.pcap'

> > +

> > +Set up linux's tcpdump to receiver packet on tester::

> > +      tcpdump -i <rx port name> -w /tmp/sniff-<rx port name>.pcap

> > +      tcpdump -i <tx port name> -w /tmp/sniff-<tx port name>.pcap

> > +

> > +Send packet on tester by port 0::

> > +    sendp(<packet format>, iface=<port 0 name>)

> > +

> > +Compare pcap file of scapy with the pcap file dumped by tcpdump.

> > +Compare pcap file dumped by dpdk-pdump with pcap files dumped by tcpdump.

> > +

> > +Send packet on tester by port 1::

> > +    sendp(<packet format>, iface=<port 1 name>)

> > +

> > +Compare pcap file of scapy with the pcap file dumped by tcpdump.

> > +Compare pcap file dumped by dpdk-pdump with pcap files dumped by tcpdump.

> > +

> > +Test Case 2: test pdump queue

> > +=================================

> > +test different queue options::

> > +* first queue:

> > +  queue=0

> > +* all:

> > +  queue=*

> 

> Please add some basic description of this parameter. Like "Capture first queue \
> traffic".

> > +

> > +Boot up dpdk's testpmd with chained option::

> > +      ./x86_64-native-linuxapp-gcc/app/testpmd -c 0x6 -n 4 -- -i --port-

> > topology=chained

> > +      testpmd> set fwd io

> > +      testpmd> start

> > +

> > +When test VLAN_UDP type packet transmission, set vlan:

> > +    testpmd> vlan set filter off 1

> > +    testpmd> start

> > +

> > +Boot up dpdk-pdump::

> > +    ./x86_64-native-linuxapp-gcc/app/dpdk-pdump -- --pdump  'port=0,<queue

> > option>,\

> > +    tx-dev=/tmp/pdump-tx.pcap,rx-dev=/tmp/pdump-rx.pcap'

> > +

> > +Set up linux's tcpdump to receiver packet on tester::

> > +      tcpdump -i <rx port name> -w /tmp/sniff-<rx port name>.pcap

> > +      tcpdump -i <tx port name> -w /tmp/sniff-<tx port name>.pcap

> > +

> > +Send packet on tester by port 0::

> > +    sendp(<packet format>, iface=<port 0 name>)

> > +

> > +Compare pcap file of scapy with the pcap file dumped by tcpdump.

> > +Compare pcap file dumped by dpdk-pdump with pcap files dumped by tcpdump.

> > +

> > +Send packet on tester by port 1::

> > +    sendp(<packet format>, iface=<port 1 name>)

> > +

> > +Compare pcap file of scapy with the pcap file dumped by tcpdump.

> > +Compare pcap file dumped by dpdk-pdump with pcap files dumped by tcpdump.

> > +

> > +Test Case 3: test pdump dev pcap

> > +=================================

> 

> Underscore please align with test case name.

> 

> > +test different dump options::

> > +* tx-dev=/tmp/pdump-tx.pcap,rx-dev=/tmp/pdump-rx.pcap

> > +* rx-dev=/tmp/pdump-rx.pcap

> > +* tx-dev=/tmp/pdump-tx.pcap

> 

> Same as previous comment, add basic descriptions for these parameters.

> 

> > +

> > +Boot up dpdk's testpmd with chained option::

> > +      ./x86_64-native-linuxapp-gcc/app/testpmd -c 0x6 -n 4 -- -i --port-

> > topology=chained

> > +      testpmd> set fwd io

> > +      testpmd> start

> > +

> > +When test VLAN_UDP type packet transmission, set vlan:

> > +    testpmd> vlan set filter off 1

> > +    testpmd> start

> > +

> > +Boot up dpdk-pdump with pdump options::

> > +    ./x86_64-native-linuxapp-gcc/app/dpdk-pdump -- --pdump

> > 'port=0,queue=*,<dump object>'

> > +

> > +Set up linux's tcpdump to receiver packet on tester::

> > +      tcpdump -i <rx port name> -w /tmp/sniff-<rx port name>.pcap

> > +      tcpdump -i <tx port name> -w /tmp/sniff-<tx port name>.pcap

> > +

> > +Send packet on tester by port 0::

> > +    sendp(<packet format>, iface=<port 0 name>)

> > +

> > +Compare pcap file of scapy with the pcap file dumped by tcpdump.

> > +Compare pcap file dumped by dpdk-pdump with pcap files dumped by

> > tcpdump(ignore when only set tx-dev).

> > +

> > +Send packet on tester by port 1::

> > +    sendp(<packet format>, iface=<port 1 name>)

> > +

> > +Compare pcap file of scapy with the pcap file dumped by tcpdump.

> > +Compare pcap file dumped by dpdk-pdump with pcap files dumped by

> > tcpdump(ignore when only set rx-dev).

> > +

> > +Test Case 4: test pdump dev iface

> > +=================================

> > +test different dump options::

> > +* tx-dev=<dut tx port name>,rx-dev=<dut rx port name>

> > +* rx-dev=<dut rx port name>

> > +* tx-dev=<dut tx port name>

> > +

> > +Boot up dpdk's testpmd with chained option::

> > +      ./x86_64-native-linuxapp-gcc/app/testpmd -c 0x6 -n 4 -- -i --port-

> > topology=chained

> > +      testpmd> set fwd io

> > +      testpmd> start

> > +

> > +When test VLAN_UDP type packet transmission, set vlan:

> > +    testpmd> vlan set filter off 1

> > +    testpmd> start

> > +

> > +Boot up dpdk-pdump with pdump options::

> > +    ./x86_64-native-linuxapp-gcc/app/dpdk-pdump -- --pdump

> > 'port=0,queue=*,<dump object>'

> > +

> > +Set up linux's tcpdump to receiver packet on tester::

> > +      tcpdump -i <rx port name> -w /tmp/sniff-<rx port name>.pcap

> > +      tcpdump -i <tx port name> -w /tmp/sniff-<tx port name>.pcap

> > +

> > +Set up linux's tcpdump to receiver packet of dpdk-pdump on Dut::

> > +      when rx-dev is set

> > +      tcpdump -i <dut rx port name> -w /tmp/pdump-rx.pcap

> > +

> > +      when tx-dev is set

> > +      tcpdump -i <dut tx port name> -w /tmp/pdump-tx.pcap

> > +

> > +Send packet on tester by port 0::

> > +    sendp(<packet format>, iface=<port 0 name>)

> > +

> > +Compare pcap file of scapy with the pcap file dumped by tcpdump.

> > +Compare pcap file dumped by dpdk-pdump with pcap files dumped by

> > tcpdump(ignore when only set tx-dev).

> > +

> > +Send packet on tester by port 1::

> > +    sendp(<packet format>, iface=<port 1 name>)

> > +

> > +Compare pcap file of scapy with the pcap file dumped by tcpdump.

> > +Compare pcap file dumped by dpdk-pdump with pcap files dumped by

> > tcpdump(ignore when only set rx-dev).

> > +

> > +Test Case 5: test pdump ring size

> > +=================================

> > +test ring size option, set value within 2^[1~27]

> > +

> > +Boot up dpdk's testpmd with chained option::

> > +      ./x86_64-native-linuxapp-gcc/app/testpmd -c 0x6 -n 4 -- -i --port-

> > topology=chained

> > +      testpmd> set fwd io

> > +      testpmd> start

> > +

> > +When test VLAN_UDP type packet transmission, set vlan:

> > +    testpmd> vlan set filter off 1

> > +    testpmd> start

> > +

> > +Boot up dpdk-pdump with pdump options::

> > +    ./x86_64-native-linuxapp-gcc/app/dpdk-pdump -- --pdump

> > 'port=0,queue=*,\

> > +    tx-dev=/tmp/pdump-tx.pcap,rx-dev=/tmp/pdump-rx.pcap,ring-size=1024'

> > +

> > +Set up linux's tcpdump to receiver packet on tester::

> > +      tcpdump -i <rx port name> -w /tmp/sniff-<rx port name>.pcap

> > +      tcpdump -i <tx port name> -w /tmp/sniff-<tx port name>.pcap

> > +

> > +Send packet on tester by port 0::

> > +    sendp(<packet format>, iface=<port 0 name>)

> > +

> > +Compare pcap file of scapy with the pcap file dumped by tcpdump.

> > +Compare pcap file dumped by dpdk-pdump with pcap files dumped by tcpdump.

> > +

> > +Send packet on tester by port 1::

> > +    sendp(<packet format>, iface=<port 1 name>)

> > +

> > +Compare pcap file of scapy with the pcap file dumped by tcpdump.

> > +Compare pcap file dumped by dpdk-pdump with pcap files dumped by tcpdump.

> > +

> > +Test Case 6: test pdump mbuf size

> > +=================================

> > +test mbuf size option, set value within [252~59520]. min value is

> > +decided by single packet size, max value is decided by test platform memery

> > size.

> 

> Typo issue, should be "memory".

> Should here to verify what will be happened when packet size is over mbuf size?

[Mo, YufengX] when size is beyon the range, dpdk-pdump won't boot up. Do you want to \
add a verification.

will it do the same verification for other range checking?

> Suggest add one case for jumbo frame packet capture, not sure whether jumbo frame \
> should be validated here.

[Mo, YufengX]  Do you mean to write a new case for jumbo frame?

> 

> > +

> > +

> > +Boot up dpdk's testpmd with chained option::



> > +      ./x86_64-native-linuxapp-gcc/app/testpmd -c 0x6 -n 4 -- -i --port-

> > topology=chained

> > +      testpmd> set fwd io

> > +      testpmd> start

> > +

> > +When test VLAN_UDP type packet transmission, set vlan:

> > +    testpmd> vlan set filter off 1

> > +    testpmd> start

> > +

> > +Boot up dpdk-pdump with pdump options::

> > +    ./x86_64-native-linuxapp-gcc/app/dpdk-pdump -- --pdump

> > 'port=0,queue=*,\

> > +    tx-dev=/tmp/pdump-tx.pcap,rx-dev=/tmp/pdump-rx.pcap,mbuf-size=2048'

> > +

> > +Set up linux's tcpdump to receiver packet on tester::

> > +      tcpdump -i <rx port name> -w /tmp/sniff-<rx port name>.pcap

> > +      tcpdump -i <tx port name> -w /tmp/sniff-<tx port name>.pcap

> > +

> > +Send packet on tester by port 0::

> > +    sendp(<packet format>, iface=<port 0 name>)

> > +

> > +Compare pcap file of scapy with the pcap file dumped by tcpdump.

> > +Compare pcap file dumped by dpdk-pdump with pcap files dumped by tcpdump.

> > +

> > +Send packet on tester by port 1::

> > +    sendp(<packet format>, iface=<port 1 name>)

> > +

> > +Compare pcap file of scapy with the pcap file dumped by tcpdump.

> > +Compare pcap file dumped by dpdk-pdump with pcap files dumped by tcpdump.

> > +

> > +Test Case 7: test pdump total num mbufs

> > +=================================

> > +test total-num-mbufs option, set value within [1025~65535]

> 

> What will be affected when change the number?  I think mbuf will be freed after \
> packet saved into pcap file.

> Will it affect the performance?

[Mo, YufengX] no things happen when total-num-mbufs changes. Currently, test case \
will reboot dpdk-pdump/testpmd

after each different option finish testing.

Within those email discussed with Reshma, she has mentioned that dpdk-pdump don't \
work for performance, you are are in

maillist too.

> 

> > +

> > +Boot up dpdk's testpmd with chained option::

> > +      ./x86_64-native-linuxapp-gcc/app/testpmd -c 0x6 -n 4 -- -i --port-

> > topology=chained

> > +      testpmd> set fwd io

> > +      testpmd> start

> > +

> > +When test VLAN_UDP type packet transmission, set vlan:

> > +    testpmd> vlan set filter off 1

> > +    testpmd> start

> > +

> > +Boot up dpdk-pdump with pdump options::

> > +    ./x86_64-native-linuxapp-gcc/app/dpdk-pdump -- --pdump

> > 'port=0,queue=*,\

> > +    tx-dev=/tmp/pdump-tx.pcap,rx-dev=/tmp/pdump-rx.pcap,total-num-

> > mbufs=8191'

> > +

> > +Set up linux's tcpdump to receiver packet on tester::

> > +      tcpdump -i <rx port name> -w /tmp/sniff-<rx port name>.pcap

> > +      tcpdump -i <tx port name> -w /tmp/sniff-<tx port name>.pcap

> > +

> > +Send packet on tester by port 0::

> > +    sendp(<packet format>, iface=<port 0 name>)

> > +

> > +Compare pcap file of scapy with the pcap file dumped by tcpdump.

> > +Compare pcap file dumped by dpdk-pdump with pcap files dumped by tcpdump.

> > +

> > +Send packet on tester by port 1::

> > +    sendp(<packet format>, iface=<port 1 name>)

> > +

> > +Compare pcap file of scapy with the pcap file dumped by tcpdump.

> > +Compare pcap file dumped by dpdk-pdump with pcap files dumped by tcpdump.

> > +

> > --

> > 1.9.3


[Attachment #3 (text/html)]

<html xmlns:v="urn:schemas-microsoft-com:vml" \
xmlns:o="urn:schemas-microsoft-com:office:office" \
xmlns:w="urn:schemas-microsoft-com:office:word" \
xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" \
xmlns="http://www.w3.org/TR/REC-html40"> <head>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
<meta name="ProgId" content="Word.Document">
<meta name="Generator" content="Microsoft Word 14">
<meta name="Originator" content="Microsoft Word 14">
<link rel="File-List" href="cid:filelist.xml@01D26FFD.3DEEB9B0"><!--[if gte mso \
9]><xml> <o:OfficeDocumentSettings>
<o:AllowPNG/>
</o:OfficeDocumentSettings>
</xml><![endif]--><!--[if gte mso 9]><xml>
<w:WordDocument>
<w:SpellingState>Clean</w:SpellingState>
<w:TrackMoves/>
<w:TrackFormatting/>
<w:EnvelopeVis/>
<w:PunctuationKerning/>
<w:ValidateAgainstSchemas/>
<w:SaveIfXMLInvalid>false</w:SaveIfXMLInvalid>
<w:IgnoreMixedContent>false</w:IgnoreMixedContent>
<w:AlwaysShowPlaceholderText>false</w:AlwaysShowPlaceholderText>
<w:DoNotPromoteQF/>
<w:LidThemeOther>EN-US</w:LidThemeOther>
<w:LidThemeAsian>ZH-CN</w:LidThemeAsian>
<w:LidThemeComplexScript>X-NONE</w:LidThemeComplexScript>
<w:Compatibility>
<w:BreakWrappedTables/>
<w:SnapToGridInCell/>
<w:WrapTextWithPunct/>
<w:UseAsianBreakRules/>
<w:DontGrowAutofit/>
<w:SplitPgBreakAndParaMark/>
<w:EnableOpenTypeKerning/>
<w:DontFlipMirrorIndents/>
<w:OverrideTableStyleHps/>
<w:UseFELayout/>
</w:Compatibility>
<m:mathPr>
<m:mathFont m:val="Cambria Math"/>
<m:brkBin m:val="before"/>
<m:brkBinSub m:val="&#45;-"/>
<m:smallFrac m:val="off"/>
<m:dispDef/>
<m:lMargin m:val="0"/>
<m:rMargin m:val="0"/>
<m:defJc m:val="centerGroup"/>
<m:wrapIndent m:val="1440"/>
<m:intLim m:val="subSup"/>
<m:naryLim m:val="undOvr"/>
</m:mathPr></w:WordDocument>
</xml><![endif]--><!--[if gte mso 9]><xml>
<w:LatentStyles DefLockedState="false" DefUnhideWhenUsed="true" DefSemiHidden="true" \
DefQFormat="false" DefPriority="99" LatentStyleCount="267"> <w:LsdException \
Locked="false" Priority="0" SemiHidden="false" UnhideWhenUsed="false" QFormat="true" \
Name="Normal"/> <w:LsdException Locked="false" Priority="9" SemiHidden="false" \
UnhideWhenUsed="false" QFormat="true" Name="heading 1"/> <w:LsdException \
Locked="false" Priority="9" QFormat="true" Name="heading 2"/> <w:LsdException \
Locked="false" Priority="9" QFormat="true" Name="heading 3"/> <w:LsdException \
Locked="false" Priority="9" QFormat="true" Name="heading 4"/> <w:LsdException \
Locked="false" Priority="9" QFormat="true" Name="heading 5"/> <w:LsdException \
Locked="false" Priority="9" QFormat="true" Name="heading 6"/> <w:LsdException \
Locked="false" Priority="9" QFormat="true" Name="heading 7"/> <w:LsdException \
Locked="false" Priority="9" QFormat="true" Name="heading 8"/> <w:LsdException \
Locked="false" Priority="9" QFormat="true" Name="heading 9"/> <w:LsdException \
Locked="false" Priority="39" Name="toc 1"/> <w:LsdException Locked="false" \
Priority="39" Name="toc 2"/> <w:LsdException Locked="false" Priority="39" Name="toc \
3"/> <w:LsdException Locked="false" Priority="39" Name="toc 4"/>
<w:LsdException Locked="false" Priority="39" Name="toc 5"/>
<w:LsdException Locked="false" Priority="39" Name="toc 6"/>
<w:LsdException Locked="false" Priority="39" Name="toc 7"/>
<w:LsdException Locked="false" Priority="39" Name="toc 8"/>
<w:LsdException Locked="false" Priority="39" Name="toc 9"/>
<w:LsdException Locked="false" Priority="35" QFormat="true" Name="caption"/>
<w:LsdException Locked="false" Priority="10" SemiHidden="false" \
UnhideWhenUsed="false" QFormat="true" Name="Title"/> <w:LsdException Locked="false" \
Priority="1" Name="Default Paragraph Font"/> <w:LsdException Locked="false" \
Priority="11" SemiHidden="false" UnhideWhenUsed="false" QFormat="true" \
Name="Subtitle"/> <w:LsdException Locked="false" Priority="22" SemiHidden="false" \
UnhideWhenUsed="false" QFormat="true" Name="Strong"/> <w:LsdException Locked="false" \
Priority="20" SemiHidden="false" UnhideWhenUsed="false" QFormat="true" \
Name="Emphasis"/> <w:LsdException Locked="false" Priority="59" SemiHidden="false" \
UnhideWhenUsed="false" Name="Table Grid"/> <w:LsdException Locked="false" \
UnhideWhenUsed="false" Name="Placeholder Text"/> <w:LsdException Locked="false" \
Priority="1" SemiHidden="false" UnhideWhenUsed="false" QFormat="true" Name="No \
Spacing"/> <w:LsdException Locked="false" Priority="60" SemiHidden="false" \
UnhideWhenUsed="false" Name="Light Shading"/> <w:LsdException Locked="false" \
Priority="61" SemiHidden="false" UnhideWhenUsed="false" Name="Light List"/> \
<w:LsdException Locked="false" Priority="62" SemiHidden="false" \
UnhideWhenUsed="false" Name="Light Grid"/> <w:LsdException Locked="false" \
Priority="63" SemiHidden="false" UnhideWhenUsed="false" Name="Medium Shading 1"/> \
<w:LsdException Locked="false" Priority="64" SemiHidden="false" \
UnhideWhenUsed="false" Name="Medium Shading 2"/> <w:LsdException Locked="false" \
Priority="65" SemiHidden="false" UnhideWhenUsed="false" Name="Medium List 1"/> \
<w:LsdException Locked="false" Priority="66" SemiHidden="false" \
UnhideWhenUsed="false" Name="Medium List 2"/> <w:LsdException Locked="false" \
Priority="67" SemiHidden="false" UnhideWhenUsed="false" Name="Medium Grid 1"/> \
<w:LsdException Locked="false" Priority="68" SemiHidden="false" \
UnhideWhenUsed="false" Name="Medium Grid 2"/> <w:LsdException Locked="false" \
Priority="69" SemiHidden="false" UnhideWhenUsed="false" Name="Medium Grid 3"/> \
<w:LsdException Locked="false" Priority="70" SemiHidden="false" \
UnhideWhenUsed="false" Name="Dark List"/> <w:LsdException Locked="false" \
Priority="71" SemiHidden="false" UnhideWhenUsed="false" Name="Colorful Shading"/> \
<w:LsdException Locked="false" Priority="72" SemiHidden="false" \
UnhideWhenUsed="false" Name="Colorful List"/> <w:LsdException Locked="false" \
Priority="73" SemiHidden="false" UnhideWhenUsed="false" Name="Colorful Grid"/> \
<w:LsdException Locked="false" Priority="60" SemiHidden="false" \
UnhideWhenUsed="false" Name="Light Shading Accent 1"/> <w:LsdException Locked="false" \
Priority="61" SemiHidden="false" UnhideWhenUsed="false" Name="Light List Accent 1"/> \
<w:LsdException Locked="false" Priority="62" SemiHidden="false" \
UnhideWhenUsed="false" Name="Light Grid Accent 1"/> <w:LsdException Locked="false" \
Priority="63" SemiHidden="false" UnhideWhenUsed="false" Name="Medium Shading 1 Accent \
1"/> <w:LsdException Locked="false" Priority="64" SemiHidden="false" \
UnhideWhenUsed="false" Name="Medium Shading 2 Accent 1"/> <w:LsdException \
Locked="false" Priority="65" SemiHidden="false" UnhideWhenUsed="false" Name="Medium \
List 1 Accent 1"/> <w:LsdException Locked="false" UnhideWhenUsed="false" \
Name="Revision"/> <w:LsdException Locked="false" Priority="34" SemiHidden="false" \
UnhideWhenUsed="false" QFormat="true" Name="List Paragraph"/> <w:LsdException \
Locked="false" Priority="29" SemiHidden="false" UnhideWhenUsed="false" QFormat="true" \
Name="Quote"/> <w:LsdException Locked="false" Priority="30" SemiHidden="false" \
UnhideWhenUsed="false" QFormat="true" Name="Intense Quote"/> <w:LsdException \
Locked="false" Priority="66" SemiHidden="false" UnhideWhenUsed="false" Name="Medium \
List 2 Accent 1"/> <w:LsdException Locked="false" Priority="67" SemiHidden="false" \
UnhideWhenUsed="false" Name="Medium Grid 1 Accent 1"/> <w:LsdException Locked="false" \
Priority="68" SemiHidden="false" UnhideWhenUsed="false" Name="Medium Grid 2 Accent \
1"/> <w:LsdException Locked="false" Priority="69" SemiHidden="false" \
UnhideWhenUsed="false" Name="Medium Grid 3 Accent 1"/> <w:LsdException Locked="false" \
Priority="70" SemiHidden="false" UnhideWhenUsed="false" Name="Dark List Accent 1"/> \
<w:LsdException Locked="false" Priority="71" SemiHidden="false" \
UnhideWhenUsed="false" Name="Colorful Shading Accent 1"/> <w:LsdException \
Locked="false" Priority="72" SemiHidden="false" UnhideWhenUsed="false" Name="Colorful \
List Accent 1"/> <w:LsdException Locked="false" Priority="73" SemiHidden="false" \
UnhideWhenUsed="false" Name="Colorful Grid Accent 1"/> <w:LsdException Locked="false" \
Priority="60" SemiHidden="false" UnhideWhenUsed="false" Name="Light Shading Accent \
2"/> <w:LsdException Locked="false" Priority="61" SemiHidden="false" \
UnhideWhenUsed="false" Name="Light List Accent 2"/> <w:LsdException Locked="false" \
Priority="62" SemiHidden="false" UnhideWhenUsed="false" Name="Light Grid Accent 2"/> \
<w:LsdException Locked="false" Priority="63" SemiHidden="false" \
UnhideWhenUsed="false" Name="Medium Shading 1 Accent 2"/> <w:LsdException \
Locked="false" Priority="64" SemiHidden="false" UnhideWhenUsed="false" Name="Medium \
Shading 2 Accent 2"/> <w:LsdException Locked="false" Priority="65" SemiHidden="false" \
UnhideWhenUsed="false" Name="Medium List 1 Accent 2"/> <w:LsdException Locked="false" \
Priority="66" SemiHidden="false" UnhideWhenUsed="false" Name="Medium List 2 Accent \
2"/> <w:LsdException Locked="false" Priority="67" SemiHidden="false" \
UnhideWhenUsed="false" Name="Medium Grid 1 Accent 2"/> <w:LsdException Locked="false" \
Priority="68" SemiHidden="false" UnhideWhenUsed="false" Name="Medium Grid 2 Accent \
2"/> <w:LsdException Locked="false" Priority="69" SemiHidden="false" \
UnhideWhenUsed="false" Name="Medium Grid 3 Accent 2"/> <w:LsdException Locked="false" \
Priority="70" SemiHidden="false" UnhideWhenUsed="false" Name="Dark List Accent 2"/> \
<w:LsdException Locked="false" Priority="71" SemiHidden="false" \
UnhideWhenUsed="false" Name="Colorful Shading Accent 2"/> <w:LsdException \
Locked="false" Priority="72" SemiHidden="false" UnhideWhenUsed="false" Name="Colorful \
List Accent 2"/> <w:LsdException Locked="false" Priority="73" SemiHidden="false" \
UnhideWhenUsed="false" Name="Colorful Grid Accent 2"/> <w:LsdException Locked="false" \
Priority="60" SemiHidden="false" UnhideWhenUsed="false" Name="Light Shading Accent \
3"/> <w:LsdException Locked="false" Priority="61" SemiHidden="false" \
UnhideWhenUsed="false" Name="Light List Accent 3"/> <w:LsdException Locked="false" \
Priority="62" SemiHidden="false" UnhideWhenUsed="false" Name="Light Grid Accent 3"/> \
<w:LsdException Locked="false" Priority="63" SemiHidden="false" \
UnhideWhenUsed="false" Name="Medium Shading 1 Accent 3"/> <w:LsdException \
Locked="false" Priority="64" SemiHidden="false" UnhideWhenUsed="false" Name="Medium \
Shading 2 Accent 3"/> <w:LsdException Locked="false" Priority="65" SemiHidden="false" \
UnhideWhenUsed="false" Name="Medium List 1 Accent 3"/> <w:LsdException Locked="false" \
Priority="66" SemiHidden="false" UnhideWhenUsed="false" Name="Medium List 2 Accent \
3"/> <w:LsdException Locked="false" Priority="67" SemiHidden="false" \
UnhideWhenUsed="false" Name="Medium Grid 1 Accent 3"/> <w:LsdException Locked="false" \
Priority="68" SemiHidden="false" UnhideWhenUsed="false" Name="Medium Grid 2 Accent \
3"/> <w:LsdException Locked="false" Priority="69" SemiHidden="false" \
UnhideWhenUsed="false" Name="Medium Grid 3 Accent 3"/> <w:LsdException Locked="false" \
Priority="70" SemiHidden="false" UnhideWhenUsed="false" Name="Dark List Accent 3"/> \
<w:LsdException Locked="false" Priority="71" SemiHidden="false" \
UnhideWhenUsed="false" Name="Colorful Shading Accent 3"/> <w:LsdException \
Locked="false" Priority="72" SemiHidden="false" UnhideWhenUsed="false" Name="Colorful \
List Accent 3"/> <w:LsdException Locked="false" Priority="73" SemiHidden="false" \
UnhideWhenUsed="false" Name="Colorful Grid Accent 3"/> <w:LsdException Locked="false" \
Priority="60" SemiHidden="false" UnhideWhenUsed="false" Name="Light Shading Accent \
4"/> <w:LsdException Locked="false" Priority="61" SemiHidden="false" \
UnhideWhenUsed="false" Name="Light List Accent 4"/> <w:LsdException Locked="false" \
Priority="62" SemiHidden="false" UnhideWhenUsed="false" Name="Light Grid Accent 4"/> \
<w:LsdException Locked="false" Priority="63" SemiHidden="false" \
UnhideWhenUsed="false" Name="Medium Shading 1 Accent 4"/> <w:LsdException \
Locked="false" Priority="64" SemiHidden="false" UnhideWhenUsed="false" Name="Medium \
Shading 2 Accent 4"/> <w:LsdException Locked="false" Priority="65" SemiHidden="false" \
UnhideWhenUsed="false" Name="Medium List 1 Accent 4"/> <w:LsdException Locked="false" \
Priority="66" SemiHidden="false" UnhideWhenUsed="false" Name="Medium List 2 Accent \
4"/> <w:LsdException Locked="false" Priority="67" SemiHidden="false" \
UnhideWhenUsed="false" Name="Medium Grid 1 Accent 4"/> <w:LsdException Locked="false" \
Priority="68" SemiHidden="false" UnhideWhenUsed="false" Name="Medium Grid 2 Accent \
4"/> <w:LsdException Locked="false" Priority="69" SemiHidden="false" \
UnhideWhenUsed="false" Name="Medium Grid 3 Accent 4"/> <w:LsdException Locked="false" \
Priority="70" SemiHidden="false" UnhideWhenUsed="false" Name="Dark List Accent 4"/> \
<w:LsdException Locked="false" Priority="71" SemiHidden="false" \
UnhideWhenUsed="false" Name="Colorful Shading Accent 4"/> <w:LsdException \
Locked="false" Priority="72" SemiHidden="false" UnhideWhenUsed="false" Name="Colorful \
List Accent 4"/> <w:LsdException Locked="false" Priority="73" SemiHidden="false" \
UnhideWhenUsed="false" Name="Colorful Grid Accent 4"/> <w:LsdException Locked="false" \
Priority="60" SemiHidden="false" UnhideWhenUsed="false" Name="Light Shading Accent \
5"/> <w:LsdException Locked="false" Priority="61" SemiHidden="false" \
UnhideWhenUsed="false" Name="Light List Accent 5"/> <w:LsdException Locked="false" \
Priority="62" SemiHidden="false" UnhideWhenUsed="false" Name="Light Grid Accent 5"/> \
<w:LsdException Locked="false" Priority="63" SemiHidden="false" \
UnhideWhenUsed="false" Name="Medium Shading 1 Accent 5"/> <w:LsdException \
Locked="false" Priority="64" SemiHidden="false" UnhideWhenUsed="false" Name="Medium \
Shading 2 Accent 5"/> <w:LsdException Locked="false" Priority="65" SemiHidden="false" \
UnhideWhenUsed="false" Name="Medium List 1 Accent 5"/> <w:LsdException Locked="false" \
Priority="66" SemiHidden="false" UnhideWhenUsed="false" Name="Medium List 2 Accent \
5"/> <w:LsdException Locked="false" Priority="67" SemiHidden="false" \
UnhideWhenUsed="false" Name="Medium Grid 1 Accent 5"/> <w:LsdException Locked="false" \
Priority="68" SemiHidden="false" UnhideWhenUsed="false" Name="Medium Grid 2 Accent \
5"/> <w:LsdException Locked="false" Priority="69" SemiHidden="false" \
UnhideWhenUsed="false" Name="Medium Grid 3 Accent 5"/> <w:LsdException Locked="false" \
Priority="70" SemiHidden="false" UnhideWhenUsed="false" Name="Dark List Accent 5"/> \
<w:LsdException Locked="false" Priority="71" SemiHidden="false" \
UnhideWhenUsed="false" Name="Colorful Shading Accent 5"/> <w:LsdException \
Locked="false" Priority="72" SemiHidden="false" UnhideWhenUsed="false" Name="Colorful \
List Accent 5"/> <w:LsdException Locked="false" Priority="73" SemiHidden="false" \
UnhideWhenUsed="false" Name="Colorful Grid Accent 5"/> <w:LsdException Locked="false" \
Priority="60" SemiHidden="false" UnhideWhenUsed="false" Name="Light Shading Accent \
6"/> <w:LsdException Locked="false" Priority="61" SemiHidden="false" \
UnhideWhenUsed="false" Name="Light List Accent 6"/> <w:LsdException Locked="false" \
Priority="62" SemiHidden="false" UnhideWhenUsed="false" Name="Light Grid Accent 6"/> \
<w:LsdException Locked="false" Priority="63" SemiHidden="false" \
UnhideWhenUsed="false" Name="Medium Shading 1 Accent 6"/> <w:LsdException \
Locked="false" Priority="64" SemiHidden="false" UnhideWhenUsed="false" Name="Medium \
Shading 2 Accent 6"/> <w:LsdException Locked="false" Priority="65" SemiHidden="false" \
UnhideWhenUsed="false" Name="Medium List 1 Accent 6"/> <w:LsdException Locked="false" \
Priority="66" SemiHidden="false" UnhideWhenUsed="false" Name="Medium List 2 Accent \
6"/> <w:LsdException Locked="false" Priority="67" SemiHidden="false" \
UnhideWhenUsed="false" Name="Medium Grid 1 Accent 6"/> <w:LsdException Locked="false" \
Priority="68" SemiHidden="false" UnhideWhenUsed="false" Name="Medium Grid 2 Accent \
6"/> <w:LsdException Locked="false" Priority="69" SemiHidden="false" \
UnhideWhenUsed="false" Name="Medium Grid 3 Accent 6"/> <w:LsdException Locked="false" \
Priority="70" SemiHidden="false" UnhideWhenUsed="false" Name="Dark List Accent 6"/> \
<w:LsdException Locked="false" Priority="71" SemiHidden="false" \
UnhideWhenUsed="false" Name="Colorful Shading Accent 6"/> <w:LsdException \
Locked="false" Priority="72" SemiHidden="false" UnhideWhenUsed="false" Name="Colorful \
List Accent 6"/> <w:LsdException Locked="false" Priority="73" SemiHidden="false" \
UnhideWhenUsed="false" Name="Colorful Grid Accent 6"/> <w:LsdException Locked="false" \
Priority="19" SemiHidden="false" UnhideWhenUsed="false" QFormat="true" Name="Subtle \
Emphasis"/> <w:LsdException Locked="false" Priority="21" SemiHidden="false" \
UnhideWhenUsed="false" QFormat="true" Name="Intense Emphasis"/> <w:LsdException \
Locked="false" Priority="31" SemiHidden="false" UnhideWhenUsed="false" QFormat="true" \
Name="Subtle Reference"/> <w:LsdException Locked="false" Priority="32" \
SemiHidden="false" UnhideWhenUsed="false" QFormat="true" Name="Intense Reference"/> \
<w:LsdException Locked="false" Priority="33" SemiHidden="false" \
UnhideWhenUsed="false" QFormat="true" Name="Book Title"/> <w:LsdException \
Locked="false" Priority="37" Name="Bibliography"/> <w:LsdException Locked="false" \
Priority="39" QFormat="true" Name="TOC Heading"/> </w:LatentStyles>
</xml><![endif]--><style><!--
/* Font Definitions */
@font-face
	{font-family:SimSun;
	panose-1:2 1 6 0 3 1 1 1 1 1;
	mso-font-alt:SimSun;
	mso-font-charset:134;
	mso-generic-font-family:auto;
	mso-font-pitch:variable;
	mso-font-signature:3 680460288 22 0 262145 0;}
@font-face
	{font-family:SimSun;
	panose-1:2 1 6 0 3 1 1 1 1 1;
	mso-font-alt:SimSun;
	mso-font-charset:134;
	mso-generic-font-family:auto;
	mso-font-pitch:variable;
	mso-font-signature:3 680460288 22 0 262145 0;}
@font-face
	{font-family:Calibri;
	panose-1:2 15 5 2 2 2 4 3 2 4;
	mso-font-alt:"Century Gothic";
	mso-font-charset:0;
	mso-generic-font-family:swiss;
	mso-font-pitch:variable;
	mso-font-signature:-520092929 1073786111 9 0 415 0;}
@font-face
	{font-family:Tahoma;
	panose-1:2 11 6 4 3 5 4 4 2 4;
	mso-font-alt:"Device Font 10cpi";
	mso-font-charset:0;
	mso-generic-font-family:swiss;
	mso-font-pitch:variable;
	mso-font-signature:-520081665 -1073717157 41 0 66047 0;}
@font-face
	{font-family:"\@SimSun";
	panose-1:2 1 6 0 3 1 1 1 1 1;
	mso-font-alt:"\@SimSun";
	mso-font-charset:134;
	mso-generic-font-family:auto;
	mso-font-pitch:variable;
	mso-font-signature:3 680460288 22 0 262145 0;}
@font-face
	{font-family:Consolas;
	panose-1:2 11 6 9 2 2 4 3 2 4;
	mso-font-alt:"Times New Roman";
	mso-font-charset:0;
	mso-generic-font-family:modern;
	mso-font-pitch:fixed;
	mso-font-signature:-520092929 1073806591 9 0 415 0;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
	{mso-style-unhide:no;
	mso-style-qformat:yes;
	mso-style-parent:"";
	margin:0pt;
	margin-bottom:.0001pt;
	mso-pagination:widow-orphan;
	font-size:11.0pt;
	font-family:"Calibri","sans-serif";
	mso-ascii-font-family:Calibri;
	mso-fareast-font-family:SimSun;
	mso-hansi-font-family:Calibri;
	mso-bidi-font-family:"Times New Roman";}
a:link, span.MsoHyperlink
	{mso-style-priority:99;
	color:blue;
	text-decoration:underline;
	text-underline:single;}
a:visited, span.MsoHyperlinkFollowed
	{mso-style-noshow:yes;
	mso-style-priority:99;
	color:purple;
	text-decoration:underline;
	text-underline:single;}
p.MsoPlainText, li.MsoPlainText, div.MsoPlainText
	{mso-style-priority:99;
	mso-style-link:"Plain Text Char";
	margin:0pt;
	margin-bottom:.0001pt;
	mso-pagination:widow-orphan;
	font-size:11.0pt;
	mso-bidi-font-size:10.5pt;
	font-family:"Calibri","sans-serif";
	mso-ascii-font-family:Calibri;
	mso-fareast-font-family:SimSun;
	mso-hansi-font-family:Calibri;
	mso-bidi-font-family:Consolas;}
p.MsoAcetate, li.MsoAcetate, div.MsoAcetate
	{mso-style-noshow:yes;
	mso-style-priority:99;
	mso-style-link:"Balloon Text Char";
	margin:0pt;
	margin-bottom:.0001pt;
	mso-pagination:widow-orphan;
	font-size:8.0pt;
	font-family:"Tahoma","sans-serif";
	mso-fareast-font-family:SimSun;}
span.PlainTextChar
	{mso-style-name:"Plain Text Char";
	mso-style-priority:99;
	mso-style-unhide:no;
	mso-style-locked:yes;
	mso-style-link:"Plain Text";
	mso-bidi-font-size:10.5pt;
	font-family:SimSun;
	mso-fareast-font-family:SimSun;
	mso-bidi-font-family:Consolas;}
span.BalloonTextChar
	{mso-style-name:"Balloon Text Char";
	mso-style-noshow:yes;
	mso-style-priority:99;
	mso-style-unhide:no;
	mso-style-locked:yes;
	mso-style-link:"Balloon Text";
	mso-ansi-font-size:8.0pt;
	mso-bidi-font-size:8.0pt;
	font-family:"Tahoma","sans-serif";
	mso-ascii-font-family:Tahoma;
	mso-hansi-font-family:Tahoma;
	mso-bidi-font-family:Tahoma;}
span.SpellE
	{mso-style-name:"";
	mso-spl-e:yes;}
.MsoChpDefault
	{mso-style-type:export-only;
	mso-default-props:yes;
	mso-ascii-font-family:Calibri;
	mso-fareast-font-family:SimSun;
	mso-hansi-font-family:Calibri;
	mso-bidi-font-family:"Times New Roman";}
@page WordSection1
	{size:612.0pt 792.0pt;
	margin:72.0pt 0pt 72.0pt 0pt;
	mso-header-margin:36.0pt;
	mso-footer-margin:36.0pt;
	mso-paper-source:0;}
div.WordSection1
	{page:WordSection1;}
--></style><!--[if gte mso 10]><style>/* Style Definitions */
table.MsoNormalTable
	{mso-style-name:"Table Normal";
	mso-tstyle-rowband-size:0;
	mso-tstyle-colband-size:0;
	mso-style-noshow:yes;
	mso-style-priority:99;
	mso-style-parent:"";
	mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
	mso-para-margin:0pt;
	mso-para-margin-bottom:.0001pt;
	mso-pagination:widow-orphan;
	font-size:11.0pt;
	font-family:"Calibri","sans-serif";
	mso-ascii-font-family:Calibri;
	mso-hansi-font-family:Calibri;
	mso-bidi-font-family:"Times New Roman";}
</style><![endif]--><!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]-->
</head>
<body lang="EN-US" link="blue" vlink="purple" style="tab-interval:36.0pt">
<div class="WordSection1">
<p class="MsoPlainText">hi, Marvin<o:p></o:p></p>
<p class="MsoPlainText"><o:p>&nbsp;</o:p></p>
<p class="MsoPlainText">see below.<o:p></o:p></p>
<p class="MsoPlainText"><o:p>&nbsp;</o:p></p>
<p class="MsoPlainText">&gt; -----Original Message-----<o:p></o:p></p>
<p class="MsoPlainText">&gt; From: Liu, Yong<o:p></o:p></p>
<p class="MsoPlainText">&gt; Sent: January 16, 2017 11:08 AM<o:p></o:p></p>
<p class="MsoPlainText">&gt; To: Mo, <span class="SpellE">YufengX</span>; \
dts@dpdk.org<o:p></o:p></p> <p class="MsoPlainText">&gt; Cc: Mo, <span \
class="SpellE">YufengX</span><o:p></o:p></p> <p class="MsoPlainText">&gt; Subject: \
RE: [<span class="SpellE">dts</span>] [PATCH V1 1/2] Packet capture: upload \
automation test plan<o:p></o:p></p> <p class="MsoPlainText">&gt; <o:p></o:p></p>
<p class="MsoPlainText">&gt; <span class="SpellE">Yufen</span>,<o:p></o:p></p>
<p class="MsoPlainText">&gt; Please make sure all lines in test plan and commit are \
limited to 79 characters.<o:p></o:p></p> <p class="MsoPlainText">&gt; And some \
comments and questions below.<o:p></o:p></p> <p class="MsoPlainText">&gt; \
<o:p></o:p></p> <p class="MsoPlainText">&gt; Thanks,<o:p></o:p></p>
<p class="MsoPlainText">&gt; Marvin<o:p></o:p></p>
<p class="MsoPlainText">&gt; <o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; -----Original Message-----<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; From: <span class="SpellE">dts</span> \
[mailto:dts-bounces@dpdk.org] On Behalf Of yufengx.mo@intel.com<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; Sent: Monday, January 16, 2017 10:49 AM<o:p></o:p></p> \
<p class="MsoPlainText">&gt; &gt; To: dts@dpdk.org<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; Cc: Mo, <span class="SpellE">YufengX</span> \
&lt;yufengx.mo@intel.com&gt;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
Subject: [<span class="SpellE">dts</span>] [PATCH V1 1/2] Packet capture: upload \
automation test plan<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt;<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; From: <span class="SpellE">yufengmx</span> \
&lt;yufengx.mo@intel.com&gt;<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt;<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; Packet capture framework feature support packet \
capturing on <span class="SpellE">dpdk</span> <span \
class="SpellE">ethernet</span><o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
devices.<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; DPDK provides <span \
class="SpellE">dpdk-pdump</span> tool under app/<span class="SpellE">pdump</span> \
directory for packet<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; capturing on \
<span class="SpellE">dpdk</span>.<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; The<span \
style="mso-spacerun:yes">&nbsp; </span>tool is a Data Plane Development Kit (DPDK) \
tool that runs as a DPDK<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; secondary \
process and is capable of enabling packet capture on <span class="SpellE">dpdk</span> \
ports.<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt;<span \
style="mso-spacerun:yes">&nbsp;&nbsp; </span>* The<span \
style="mso-spacerun:yes">&nbsp; </span>tool depends on <span \
class="SpellE">libpcap</span> based PMD which is disabled<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt;<span style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp;&nbsp; \
</span>by default in the build configuration files,<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt;<span style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp;&nbsp; \
</span>owing to an external dependency on the <span class="SpellE">libpcap</span> \
development files<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt;<span \
style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp;&nbsp; </span>which must be installed on \
the board.<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt;<span \
style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp;&nbsp; </span>Once the <span \
class="SpellE"> libpcap</span> development files are installed, the <span \
class="SpellE">libpcap</span> based PMD<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt;<span style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp;&nbsp; </span>can be enabled by \
setting CONFIG_RTE_LIBRTE_PMD_PCAP=y and<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; recompiling the DPDK.<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; Signed-off-by: <span \
class="SpellE">yufengmx</span> &lt;yufengx.mo@intel.com&gt;<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; ---<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt;<span style="mso-spacerun:yes">&nbsp; </span><span \
class="SpellE">test_plans</span>/<span \
class="SpellE">packet_capture_test_plan.rst</span> | 376<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; \
&#43;&#43;&#43;&#43;&#43;&#43;&#43;&#43;&#43;&#43;&#43;&#43;&#43;&#43;&#43;&#43;&#43;& \
#43;&#43;&#43;&#43;&#43;&#43;&#43;&#43;&#43;&#43;&#43;&#43;&#43;&#43;&#43;<o:p></o:p></p>
 <p class="MsoPlainText">&gt; &gt;<span style="mso-spacerun:yes">&nbsp; </span>1 file \
changed, 376 insertions(&#43;)<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt;<span \
style="mso-spacerun:yes">&nbsp; </span>create mode 100644 <span \
class="SpellE">test_plans</span>/<span \
class="SpellE">packet_capture_test_plan.rst</span><o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; diff \
--<span class="SpellE">git</span> a/<span class="SpellE">test_plans</span>/<span \
class="SpellE">packet_capture_test_plan.rst</span><o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; b/<span class="SpellE">test_plans</span>/<span \
class="SpellE">packet_capture_test_plan.rst</span><o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; new file mode 100644<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; index 0000000..6a51cf9<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; --- /<span \
class="SpellE">dev</span>/null<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;&#43;&#43; b/<span class="SpellE">test_plans</span>/<span \
class="SpellE">packet_capture_test_plan.rst</span><o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; @@ -0,0 &#43;1,376 @@<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;.. Copyright (c) &lt;2016&gt; Intel \
Corporation<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp; </span>All rights reserved.<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;<span style="mso-spacerun:yes">&nbsp;&nbsp; </span>Redistribution and use in \
source and binary forms, with or without<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;<span style="mso-spacerun:yes">&nbsp;&nbsp; </span>modification, are \
permitted provided that the following conditions<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;<span style="mso-spacerun:yes">&nbsp;&nbsp; \
</span>are met:<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;<span style="mso-spacerun:yes">&nbsp;&nbsp; \
</span>- Redistributions of source code must retain the above \
copyright<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp;&nbsp; </span>notice, this list of \
conditions and the following disclaimer.<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp; </span>- Redistributions in binary form must \
reproduce the above copyright<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;<span style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp;&nbsp; </span>notice, this list \
of conditions and the following disclaimer in<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp;&nbsp; </span>the documentation and/or \
other materials provided with the<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;<span style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp;&nbsp; \
</span>distribution.<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp; </span>- Neither the name of Intel Corporation \
nor the names of its<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp;&nbsp; </span>contributors may be used to \
endorse or promote products derived<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;<span style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp;&nbsp; </span>from this \
software without specific prior written permission.<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;<span style="mso-spacerun:yes">&nbsp;&nbsp; </span>THIS SOFTWARE IS PROVIDED BY \
THE COPYRIGHT HOLDERS AND<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
CONTRIBUTORS<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp; </span>&quot;AS IS&quot; AND ANY EXPRESS OR \
IMPLIED WARRANTIES, INCLUDING, BUT NOT<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;<span style="mso-spacerun:yes">&nbsp;&nbsp; </span>LIMITED TO, THE IMPLIED \
WARRANTIES OF MERCHANTABILITY AND FITNESS<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;<span style="mso-spacerun:yes">&nbsp;&nbsp; </span>FOR A PARTICULAR PURPOSE \
ARE DISCLAIMED. IN NO EVENT SHALL THE<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;<span style="mso-spacerun:yes">&nbsp;&nbsp; </span>COPYRIGHT OWNER OR \
CONTRIBUTORS BE LIABLE FOR ANY DIRECT,<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; INDIRECT,<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp; </span>INCIDENTAL, SPECIAL, EXEMPLARY, OR \
CONSEQUENTIAL DAMAGES<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp; </span>(INCLUDING, BUT NOT LIMITED TO, \
PROCUREMENT OF SUBSTITUTE GOODS<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
OR<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp; </span>SERVICES; LOSS OF USE, DATA, OR PROFITS; \
OR BUSINESS INTERRUPTION)<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp; </span>HOWEVER CAUSED AND ON ANY THEORY OF \
LIABILITY, WHETHER IN<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
CONTRACT,<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp; </span>STRICT LIABILITY, OR TORT (INCLUDING \
NEGLIGENCE OR OTHERWISE)<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp; </span>ARISING IN ANY WAY OUT OF THE USE OF \
THIS SOFTWARE, EVEN IF ADVISED<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;<span style="mso-spacerun:yes">&nbsp;&nbsp; </span>OF THE POSSIBILITY OF SUCH \
DAMAGE.<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;==================<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;<span style="mso-spacerun:yes">&nbsp; \
</span>packet capture framework feature<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;==================<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;Packet capture framework \
feature support packet capturing on <span class="SpellE">dpdk</span> <span \
class="SpellE">ethernet</span><o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
devices.<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;DPDK provides <span \
class="SpellE">dpdk-pdump</span> tool under app/<span class="SpellE">pdump</span> \
directory for packet<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; capturing on \
<span class="SpellE">dpdk</span>.<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;The <span \
class="SpellE">dpdk-pdump</span> application will act as the secondary process. The \
EAL<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;thread polls for packet \
capture <span class="SpellE"> fd</span>. If <span class="SpellE">fd</span> polled \
matches packet capture<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
class="SpellE">fd</span>, it will initiate packet capture processing.<o:p></o:p></p> \
<p class="MsoPlainText">&gt; &gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;The <span class="SpellE">testpmd</span> application will act as the primary \
process. The primary<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;process \
create socket for packet capture connection with the secondary<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;process and registers socket with packet capture \
<span class="SpellE"> epoll</span> event. Packet capture<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; event will be polled as part of interrupt \
thread.<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;The primary process creates <span \
class="SpellE">mempool</span> and two <span class="SpellE">rte_rings</span> for \
packets<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;duplication and sharing \
packet info with the secondary process respectively.<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;Upon receiving packet capture event, the primary process receive \
either<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;register RX/TX callbacks \
or remove RX/TX callbacks message from the<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;secondary process on <span \
class="SpellE">socket.If</span> packet matches, reference count of<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;packet will be incremented and <span \
class="SpellE"> enqueued</span> to second <span class="SpellE">rte_ring</span> for \
the secondary<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; process to \
use.<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;Prerequisites<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;=============<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;* 2x NICs (2 full duplex ports per NIC) \
plugged into the available<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;slots on a platform, another two <span class="SpellE"> nic</span> ports are \
linked with cables.<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;Test cases<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;=============<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;The <span class="SpellE">testpmd</span> \
application act as server process with port-topology<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;chained mode, the <span \
class="SpellE">dpdk-pdump</span> act as client process to dump capture<o:p></o:p></p> \
<p class="MsoPlainText">&gt; &gt; &#43;packet with different options setting. Select \
one port of tester as <span class="SpellE">tx</span><o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;port, another port of tester as <span \
class="SpellE"> rx</span> port, send different type packets<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;from two ports, check <span \
class="SpellE">pcap</span> files' content dumped by <span class="SpellE">scapy</span> \
and <span class="SpellE">tcpdump</span> to<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; confirm <span class="SpellE">testpmd</span> working \
correctly, check <span class="SpellE">pcap</span> files' content dumped \
by<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; <span \
class="SpellE">tcpdump</span> and <span class="SpellE"> dpdk-pdump</span> to confirm \
<span class="SpellE">dpdk-pdump</span> working correctly.<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;<span class="SpellE">dpdk-pdump</span> command format<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;--------------------------<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;* packet capture framework tool <span \
class="SpellE"> dpdk-pdump</span> command format, parameters<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;inside the parenthesis represents the \
mandatory <span class="SpellE"> parametersm</span> parameters<o:p></o:p></p>
<p class="MsoPlainText">&gt; <o:p></o:p></p>
<p class="MsoPlainText">&gt; Typo issue, &quot;<span \
class="SpellE">parametersm</span>&quot; should be ?<o:p></o:p></p> <p \
class="MsoPlainText">&gt; <o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;inside the square brackets represents optional<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;parameters::<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;./x86_64-native-linuxapp-gcc/app/<span \
class="SpellE">dpdk-pdump</span> -- --<span class="SpellE">pdump</span>= '(port \
=<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;&lt;<span \
class="SpellE">port_id</span>&gt; |<span class="SpellE">device_id</span> = &lt;<span \
class="SpellE">pci</span> address&gt;), (queue=&lt;queue number&gt;),<o:p></o:p></p> \
<p class="MsoPlainText">&gt; &gt; &#43;(<span class="SpellE">rx-dev</span>=&lt;<span \
class="SpellE">iface</span>/path to <span class="SpellE">pcap</span> file&gt; | <span \
class="SpellE">tx-dev</span>=&lt;<span class="SpellE">iface</span>/path to <span \
class="SpellE">pcap</span> file&gt;),<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;[ring-size=&lt;size&gt;], [<span \
class="SpellE">mbuf</span>-size=&lt;size&gt;], [total-<span \
class="SpellE">num</span>-<span \
class="SpellE">mbufs</span>=&lt;size&gt;]'<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;transmission packets' format<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;--------------------------<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;* IP_RAW<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp; </span>[Ether()/IP()/Raw('\0'*60)]<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;* TCP<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;<span style="mso-spacerun:yes">&nbsp; \
</span>[Ether()/IP()/TCP()/Raw('\0'*60)]<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;* UDP<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp; \
</span>[Ether()/IP()/UDP()/Raw('\0'*60)]<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;* SCTP<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp; \
</span>[Ether()/IP()/SCTP()/Raw('\0'*40)]<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;* IPv6_TCP<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp; \
</span>[Ether()/IPv6()/TCP()/Raw('\0'*60)]<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;* IPv6_UDP<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;<span style="mso-spacerun:yes">&nbsp; \
</span>[Ether()/IPv6()/UDP()/Raw('\0'*60)]<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;* IPv6_SCTP<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;<span style="mso-spacerun:yes">&nbsp; \
</span>[Ether()/IP()/IPv6()/SCTP()/Raw('\0'*40)]<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;* VLAN_UDP<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;<span style="mso-spacerun:yes">&nbsp; \
</span>[Ether()/Dot1Q()/IP()/UDP()/Raw('\0'*40)]<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;* TIMESYNC<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;<span style="mso-spacerun:yes">&nbsp; \
</span>[Ether(<span class="SpellE">dst</span>='<span \
class="SpellE">FF:FF:FF:FF:FF:FF',type</span>=0x88f7)/&quot;\\x00\\x02&quot;]<o:p></o:p></p>
 <p class="MsoPlainText">&gt; &gt; &#43;* ARP<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;<span style="mso-spacerun:yes">&nbsp; \
</span>[Ether(<span class="SpellE">dst</span>='FF:FF:FF:FF:FF:FF')/ARP()]<o:p></o:p></p>
 <p class="MsoPlainText">&gt; &gt; &#43;* LLDP<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;<span style="mso-spacerun:yes">&nbsp; \
</span>[Ether()/LLDP()/<span \
class="SpellE">LLDPManagementAddress</span>()]<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;<span style="mso-spacerun:yes">&nbsp; \
</span>notice: LLDP()/<span class="SpellE">LLDPManagementAddress</span>() method are \
in dts/dep/lldp.py<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;port \
configuration<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;--------------------------<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;* confirm two NICs physical link on a platform:<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;<span style="mso-spacerun:yes">&nbsp; \
</span><span class="SpellE">dut</span> port 0 &lt;---&gt; tester port \
0<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp; </span><span class="SpellE">dut</span> port 1 \
&lt;---&gt; tester port 1<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;* Bind two port on \
DUT::<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43; ./tools/dpdk_nic_bind.py \
--bind=<span class="SpellE">igb_uio</span> &lt;<span class="SpellE">dut</span> port 0 \
<span class="SpellE">pci</span> address&gt; &lt;<span \
class="SpellE">dut</span><o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;port \
1 <span class="SpellE">pci</span> address&gt;<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; \
Tools folder has been changed to <span \
class="SpellE">usertools</span>.<o:p></o:p></p> <p class="MsoPlainText">&gt; \
<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;* On <span \
class="SpellE">dut</span>, use port 0 as <span class="SpellE"> rx</span>/<span \
class="SpellE">tx</span> port.<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;<span style="mso-spacerun:yes">&nbsp; </span>If <span class="SpellE"> dut</span> \
port 0 <span class="SpellE">rx</span> dump is set, <span class="SpellE"> scapy</span> \
send packet from tester port 0<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;and <span class="SpellE">tcpdump</span> dumps tester<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;<span style="mso-spacerun:yes">&nbsp; </span>port \
1's packet.<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;<span style="mso-spacerun:yes">&nbsp; \
</span>If <span class="SpellE"> dut</span> port 0 <span class="SpellE">tx</span> dump \
is set, <span class="SpellE"> scapy</span> send packet from tester port \
1<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43; and <span \
class="SpellE">tcpdump</span> dumps tester<span style="mso-spacerun:yes">&nbsp; \
</span>port 0's packet.<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;* If using interfaces as \
<span class="SpellE">dpdk-pdump</span> <span class="SpellE">vdev</span>, prepare two \
ports on DUT,<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;which haven't \
been <span class="SpellE">binded</span><o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;<span style="mso-spacerun:yes">&nbsp; </span>to <span class="SpellE"> \
dpdk</span> and have been in linked status<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;Test Case 1: test <span class="SpellE">pdump</span> port<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;=================================<o:p></o:p></p> \
<p class="MsoPlainText">&gt; &gt; &#43;test different port options::<o:p></o:p></p> \
<p class="MsoPlainText">&gt; &gt; &#43;* port=&lt;<span class="SpellE">dut</span> \
port id&gt;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;* <span \
class="SpellE">device_id</span>=&lt;<span class="SpellE">dut</span> <span \
class="SpellE">pci</span> address&gt;<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;Boot up <span \
class="SpellE">dpdk's</span> <span class="SpellE"> testpmd</span> with chained \
option::<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-tab-count:1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \
</span>./x86_64-native-linuxapp-gcc/app/<span class="SpellE">testpmd</span> -c 0x6 -n \
4 -- -<span class="SpellE">i</span> --port-<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; topology=chained<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-tab-count:1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">testpmd</span>&gt; set <span class="SpellE">fwd</span> <span \
class="SpellE">io</span><o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-tab-count:1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">testpmd</span>&gt; start<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; Recommend to remove targets \
which will be change between executions.<o:p></o:p></p> <p class="MsoPlainText">&gt; \
<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;When test VLAN_UDP type packet \
transmission, set <span class="SpellE"> vlan</span>:<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">testpmd</span>&gt; <span class="SpellE">vlan</span> set filter off \
1<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">testpmd</span>&gt; start<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;Boot up <span \
class="SpellE">dpdk-pdump</span>::<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;<span style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp; \
</span>./x86_64-native-linuxapp-gcc/app/<span class="SpellE">dpdk-pdump</span> -- \
--<span class="SpellE">pdump</span><span style="mso-spacerun:yes">&nbsp; \
</span>'&lt;port<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
option&gt;,queue=*,\<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">tx-dev</span>=/<span class="SpellE">tmp</span>/<span \
class="SpellE">pdump-tx.pcap,rx-dev</span>=/<span class="SpellE">tmp</span>/<span \
class="SpellE">pdump-rx.pcap</span>'<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;Set up <span \
class="SpellE">linux's</span> <span class="SpellE"> tcpdump</span> to receiver packet \
on tester::<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-tab-count:1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">tcpdump</span> -<span class="SpellE">i</span> &lt;<span \
class="SpellE">rx</span> port name&gt; -w /<span \
class="SpellE">tmp</span>/sniff-&lt;<span class="SpellE">rx</span> port  \
name&gt;.<span class="SpellE">pcap</span><o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;<span style="mso-tab-count:1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">tcpdump</span> -<span class="SpellE">i</span> &lt;<span \
class="SpellE">tx</span> port name&gt; -w /<span \
class="SpellE">tmp</span>/sniff-&lt;<span class="SpellE">tx</span> port  \
name&gt;.<span class="SpellE">pcap</span><o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;Send packet on \
tester by port 0::<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">sendp</span>(&lt;packet format&gt;, <span \
class="SpellE">iface</span>=&lt;port 0 name&gt;)<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;Compare <span class="SpellE">pcap</span> file of <span class="SpellE"> \
scapy</span> with the <span class="SpellE">pcap</span> file dumped by <span \
class="SpellE"> tcpdump</span>.<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;Compare <span class="SpellE">pcap</span> file \
dumped by <span class="SpellE">dpdk-pdump</span> with <span \
class="SpellE">pcap</span> files dumped by <span \
class="SpellE">tcpdump</span>.<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;Send packet on tester by \
port 1::<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">sendp</span>(&lt;packet format&gt;, <span \
class="SpellE">iface</span>=&lt;port 1 name&gt;)<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;Compare <span class="SpellE">pcap</span> file of <span class="SpellE"> \
scapy</span> with the <span class="SpellE">pcap</span> file dumped by <span \
class="SpellE"> tcpdump</span>.<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;Compare <span class="SpellE">pcap</span> file \
dumped by <span class="SpellE">dpdk-pdump</span> with <span \
class="SpellE">pcap</span> files dumped by <span \
class="SpellE">tcpdump</span>.<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;Test Case 2: test <span \
class="SpellE">pdump</span> queue<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;=================================<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;test different queue options::<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;* first queue:<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp; </span>queue=0<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;* all:<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;<span style="mso-spacerun:yes">&nbsp; \
</span>queue=*<o:p></o:p></p> <p class="MsoPlainText">&gt; <o:p></o:p></p>
<p class="MsoPlainText">&gt; Please add some basic description of this parameter. \
Like &quot;Capture first queue traffic&quot;.<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;Boot up <span class="SpellE">dpdk's</span> <span class="SpellE"> testpmd</span> \
with chained option::<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-tab-count:1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \
</span>./x86_64-native-linuxapp-gcc/app/<span class="SpellE">testpmd</span> -c 0x6 -n \
4 -- -<span class="SpellE">i</span> --port-<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; topology=chained<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-tab-count:1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">testpmd</span>&gt; set <span class="SpellE">fwd</span> <span \
class="SpellE">io</span><o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-tab-count:1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">testpmd</span>&gt; start<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;When test VLAN_UDP \
type packet transmission, set <span class="SpellE"> vlan</span>:<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">testpmd</span>&gt; <span class="SpellE">vlan</span> set filter off \
1<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">testpmd</span>&gt; start<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;Boot up <span \
class="SpellE">dpdk-pdump</span>::<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;<span style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp; \
</span>./x86_64-native-linuxapp-gcc/app/<span class="SpellE">dpdk-pdump</span> -- \
--<span class="SpellE">pdump</span><span style="mso-spacerun:yes">&nbsp; \
</span>'port=0,&lt;queue<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
option&gt;,\<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">tx-dev</span>=/<span class="SpellE">tmp</span>/<span \
class="SpellE">pdump-tx.pcap,rx-dev</span>=/<span class="SpellE">tmp</span>/<span \
class="SpellE">pdump-rx.pcap</span>'<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;Set up <span \
class="SpellE">linux's</span> <span class="SpellE"> tcpdump</span> to receiver packet \
on tester::<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-tab-count:1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">tcpdump</span> -<span class="SpellE">i</span> &lt;<span \
class="SpellE">rx</span> port name&gt; -w /<span \
class="SpellE">tmp</span>/sniff-&lt;<span class="SpellE">rx</span> port  \
name&gt;.<span class="SpellE">pcap</span><o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;<span style="mso-tab-count:1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">tcpdump</span> -<span class="SpellE">i</span> &lt;<span \
class="SpellE">tx</span> port name&gt; -w /<span \
class="SpellE">tmp</span>/sniff-&lt;<span class="SpellE">tx</span> port  \
name&gt;.<span class="SpellE">pcap</span><o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;Send packet on \
tester by port 0::<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">sendp</span>(&lt;packet format&gt;, <span \
class="SpellE">iface</span>=&lt;port 0 name&gt;)<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;Compare <span class="SpellE">pcap</span> file of <span class="SpellE"> \
scapy</span> with the <span class="SpellE">pcap</span> file dumped by <span \
class="SpellE"> tcpdump</span>.<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;Compare <span class="SpellE">pcap</span> file \
dumped by <span class="SpellE">dpdk-pdump</span> with <span \
class="SpellE">pcap</span> files dumped by <span \
class="SpellE">tcpdump</span>.<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;Send packet on tester by \
port 1::<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">sendp</span>(&lt;packet format&gt;, <span \
class="SpellE">iface</span>=&lt;port 1 name&gt;)<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;Compare <span class="SpellE">pcap</span> file of <span class="SpellE"> \
scapy</span> with the <span class="SpellE">pcap</span> file dumped by <span \
class="SpellE"> tcpdump</span>.<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;Compare <span class="SpellE">pcap</span> file \
dumped by <span class="SpellE">dpdk-pdump</span> with <span \
class="SpellE">pcap</span> files dumped by <span \
class="SpellE">tcpdump</span>.<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;Test Case 3: test <span \
class="SpellE">pdump</span> <span class="SpellE"> dev</span> <span \
class="SpellE">pcap</span><o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;=================================<o:p></o:p></p> <p class="MsoPlainText">&gt; \
<o:p></o:p></p> <p class="MsoPlainText">&gt; Underscore please align with test case \
name.<o:p></o:p></p> <p class="MsoPlainText">&gt; <o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;test different dump options::<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;* <span class="SpellE">tx-dev</span>=/<span \
class="SpellE">tmp</span>/<span class="SpellE">pdump-tx.pcap,rx-dev</span>=/<span \
class="SpellE">tmp</span>/<span class="SpellE">pdump-rx.pcap</span><o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;* <span class="SpellE">rx-dev</span>=/<span \
class="SpellE">tmp</span>/<span class="SpellE">pdump-rx.pcap</span><o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;* <span class="SpellE">tx-dev</span>=/<span \
class="SpellE">tmp</span>/<span class="SpellE">pdump-tx.pcap</span><o:p></o:p></p> <p \
class="MsoPlainText">&gt; <o:p></o:p></p> <p class="MsoPlainText">&gt; Same as \
previous comment, add basic descriptions for these parameters.<o:p></o:p></p> <p \
class="MsoPlainText">&gt; <o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;Boot up <span \
class="SpellE">dpdk's</span> <span class="SpellE"> testpmd</span> with chained \
option::<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-tab-count:1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \
</span>./x86_64-native-linuxapp-gcc/app/<span class="SpellE">testpmd</span> -c 0x6 -n \
4 -- -<span class="SpellE">i</span> --port-<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; topology=chained<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-tab-count:1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">testpmd</span>&gt; set <span class="SpellE">fwd</span> <span \
class="SpellE">io</span><o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-tab-count:1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">testpmd</span>&gt; start<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;When test VLAN_UDP \
type packet transmission, set <span class="SpellE"> vlan</span>:<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">testpmd</span>&gt; <span class="SpellE">vlan</span> set filter off \
1<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">testpmd</span>&gt; start<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;Boot up <span \
class="SpellE">dpdk-pdump</span> with <span class="SpellE"> pdump</span> \
options::<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp; \
</span>./x86_64-native-linuxapp-gcc/app/<span class="SpellE">dpdk-pdump</span> -- \
--<span class="SpellE">pdump</span><o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
'port=0,queue=*,&lt;dump object&gt;'<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;Set up <span \
class="SpellE">linux's</span> <span class="SpellE"> tcpdump</span> to receiver packet \
on tester::<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-tab-count:1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">tcpdump</span> -<span class="SpellE">i</span> &lt;<span \
class="SpellE">rx</span> port name&gt; -w /<span \
class="SpellE">tmp</span>/sniff-&lt;<span class="SpellE">rx</span> port  \
name&gt;.<span class="SpellE">pcap</span><o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;<span style="mso-tab-count:1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">tcpdump</span> -<span class="SpellE">i</span> &lt;<span \
class="SpellE">tx</span> port name&gt; -w /<span \
class="SpellE">tmp</span>/sniff-&lt;<span class="SpellE">tx</span> port  \
name&gt;.<span class="SpellE">pcap</span><o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;Send packet on \
tester by port 0::<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">sendp</span>(&lt;packet format&gt;, <span \
class="SpellE">iface</span>=&lt;port 0 name&gt;)<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;Compare <span class="SpellE">pcap</span> file of <span class="SpellE"> \
scapy</span> with the <span class="SpellE">pcap</span> file dumped by <span \
class="SpellE"> tcpdump</span>.<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;Compare <span class="SpellE">pcap</span> file \
dumped by <span class="SpellE">dpdk-pdump</span> with <span \
class="SpellE">pcap</span> files dumped by<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; <span class="SpellE">tcpdump</span>(ignore when only \
set <span class="SpellE">tx-dev</span>).<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;Send packet on tester by port \
1::<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">sendp</span>(&lt;packet format&gt;, <span \
class="SpellE">iface</span>=&lt;port 1 name&gt;)<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;Compare <span class="SpellE">pcap</span> file of <span class="SpellE"> \
scapy</span> with the <span class="SpellE">pcap</span> file dumped by <span \
class="SpellE"> tcpdump</span>.<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;Compare <span class="SpellE">pcap</span> file \
dumped by <span class="SpellE">dpdk-pdump</span> with <span \
class="SpellE">pcap</span> files dumped by<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; <span class="SpellE">tcpdump</span>(ignore when only \
set <span class="SpellE">rx-dev</span>).<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;Test Case 4: test <span \
class="SpellE">pdump</span> <span class="SpellE"> dev</span> <span \
class="SpellE">iface</span><o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;=================================<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;test different dump options::<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;* <span class="SpellE">tx-dev</span>=&lt;<span class="SpellE">dut</span> \
<span class="SpellE">tx</span> port name&gt;,<span \
class="SpellE">rx-dev</span>=&lt;<span class="SpellE">dut</span> <span \
class="SpellE">rx</span> port name&gt;<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;* <span class="SpellE">rx-dev</span>=&lt;<span class="SpellE">dut</span> \
<span class="SpellE">rx</span> port name&gt;<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;* <span class="SpellE">tx-dev</span>=&lt;<span \
class="SpellE">dut</span> <span class="SpellE">tx</span> port name&gt;<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;Boot up <span class="SpellE">dpdk's</span> \
<span class="SpellE"> testpmd</span> with chained option::<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-tab-count:1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \
</span>./x86_64-native-linuxapp-gcc/app/<span class="SpellE">testpmd</span> -c 0x6 -n \
4 -- -<span class="SpellE">i</span> --port-<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; topology=chained<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-tab-count:1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">testpmd</span>&gt; set <span class="SpellE">fwd</span> <span \
class="SpellE">io</span><o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-tab-count:1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">testpmd</span>&gt; start<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;When test VLAN_UDP \
type packet transmission, set <span class="SpellE"> vlan</span>:<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">testpmd</span>&gt; <span class="SpellE">vlan</span> set filter off \
1<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">testpmd</span>&gt; start<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;Boot up <span \
class="SpellE">dpdk-pdump</span> with <span class="SpellE"> pdump</span> \
options::<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp; \
</span>./x86_64-native-linuxapp-gcc/app/<span class="SpellE">dpdk-pdump</span> -- \
--<span class="SpellE">pdump</span><o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
'port=0,queue=*,&lt;dump object&gt;'<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;Set up <span \
class="SpellE">linux's</span> <span class="SpellE"> tcpdump</span> to receiver packet \
on tester::<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-tab-count:1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">tcpdump</span> -<span class="SpellE">i</span> &lt;<span \
class="SpellE">rx</span> port name&gt; -w /<span \
class="SpellE">tmp</span>/sniff-&lt;<span class="SpellE">rx</span> port  \
name&gt;.<span class="SpellE">pcap</span><o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;<span style="mso-tab-count:1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">tcpdump</span> -<span class="SpellE">i</span> &lt;<span \
class="SpellE">tx</span> port name&gt; -w /<span \
class="SpellE">tmp</span>/sniff-&lt;<span class="SpellE">tx</span> port  \
name&gt;.<span class="SpellE">pcap</span><o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;Set up <span \
class="SpellE">linux's</span> <span class="SpellE"> tcpdump</span> to receiver packet \
of <span class="SpellE">dpdk-pdump</span> on <span class="SpellE"> \
Dut</span>::<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-tab-count:1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>when <span \
class="SpellE"> rx-dev</span> is set<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-tab-count:1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">tcpdump</span> -<span class="SpellE">i</span> &lt;<span \
class="SpellE">dut</span> <span class="SpellE">rx</span> port name&gt; -w /<span \
class="SpellE">tmp</span>/<span class="SpellE">pdump-rx.pcap</span><o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;<span style="mso-tab-count:1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>when <span \
class="SpellE"> tx-dev</span> is set<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-tab-count:1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">tcpdump</span> -<span class="SpellE">i</span> &lt;<span \
class="SpellE">dut</span> <span class="SpellE">tx</span> port name&gt; -w /<span \
class="SpellE">tmp</span>/<span class="SpellE">pdump-tx.pcap</span><o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;Send packet on tester by port 0::<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;<span style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">sendp</span>(&lt;packet format&gt;, <span \
class="SpellE">iface</span>=&lt;port 0 name&gt;)<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;Compare <span class="SpellE">pcap</span> file of <span class="SpellE"> \
scapy</span> with the <span class="SpellE">pcap</span> file dumped by <span \
class="SpellE"> tcpdump</span>.<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;Compare <span class="SpellE">pcap</span> file \
dumped by <span class="SpellE">dpdk-pdump</span> with <span \
class="SpellE">pcap</span> files dumped by<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; <span class="SpellE">tcpdump</span>(ignore when only \
set <span class="SpellE">tx-dev</span>).<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;Send packet on tester by port \
1::<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">sendp</span>(&lt;packet format&gt;, <span \
class="SpellE">iface</span>=&lt;port 1 name&gt;)<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;Compare <span class="SpellE">pcap</span> file of <span class="SpellE"> \
scapy</span> with the <span class="SpellE">pcap</span> file dumped by <span \
class="SpellE"> tcpdump</span>.<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;Compare <span class="SpellE">pcap</span> file \
dumped by <span class="SpellE">dpdk-pdump</span> with <span \
class="SpellE">pcap</span> files dumped by<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; <span class="SpellE">tcpdump</span>(ignore when only \
set <span class="SpellE">rx-dev</span>).<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;Test Case 5: test <span \
class="SpellE">pdump</span> ring size<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;=================================<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;test ring size option, set value within \
2^[1~27]<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;Boot up <span class="SpellE">dpdk's</span> \
<span class="SpellE"> testpmd</span> with chained option::<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-tab-count:1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \
</span>./x86_64-native-linuxapp-gcc/app/<span class="SpellE">testpmd</span> -c 0x6 -n \
4 -- -<span class="SpellE">i</span> --port-<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; topology=chained<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-tab-count:1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">testpmd</span>&gt; set <span class="SpellE">fwd</span> <span \
class="SpellE">io</span><o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-tab-count:1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">testpmd</span>&gt; start<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;When test VLAN_UDP \
type packet transmission, set <span class="SpellE"> vlan</span>:<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">testpmd</span>&gt; <span class="SpellE">vlan</span> set filter off \
1<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">testpmd</span>&gt; start<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;Boot up <span \
class="SpellE">dpdk-pdump</span> with <span class="SpellE"> pdump</span> \
options::<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp; \
</span>./x86_64-native-linuxapp-gcc/app/<span class="SpellE">dpdk-pdump</span> -- \
--<span class="SpellE">pdump</span><o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
'port=0,queue=*,\<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp; \
</span>tx-dev=/tmp/pdump-tx.pcap,rx-dev=/tmp/pdump-rx.pcap,ring-size=1024'<o:p></o:p></p>
 <p class="MsoPlainText">&gt; &gt; &#43;<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;Set up <span class="SpellE">linux's</span> \
<span class="SpellE"> tcpdump</span> to receiver packet on tester::<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-tab-count:1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">tcpdump</span> -<span class="SpellE">i</span> &lt;<span \
class="SpellE">rx</span> port name&gt; -w /<span \
class="SpellE">tmp</span>/sniff-&lt;<span class="SpellE">rx</span> port  \
name&gt;.<span class="SpellE">pcap</span><o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;<span style="mso-tab-count:1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">tcpdump</span> -<span class="SpellE">i</span> &lt;<span \
class="SpellE">tx</span> port name&gt; -w /<span \
class="SpellE">tmp</span>/sniff-&lt;<span class="SpellE">tx</span> port  \
name&gt;.<span class="SpellE">pcap</span><o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;Send packet on \
tester by port 0::<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">sendp</span>(&lt;packet format&gt;, <span \
class="SpellE">iface</span>=&lt;port 0 name&gt;)<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;Compare <span class="SpellE">pcap</span> file of <span class="SpellE"> \
scapy</span> with the <span class="SpellE">pcap</span> file dumped by <span \
class="SpellE"> tcpdump</span>.<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;Compare <span class="SpellE">pcap</span> file \
dumped by <span class="SpellE">dpdk-pdump</span> with <span \
class="SpellE">pcap</span> files dumped by <span \
class="SpellE">tcpdump</span>.<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;Send packet on tester by \
port 1::<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">sendp</span>(&lt;packet format&gt;, <span \
class="SpellE">iface</span>=&lt;port 1 name&gt;)<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;Compare <span class="SpellE">pcap</span> file of <span class="SpellE"> \
scapy</span> with the <span class="SpellE">pcap</span> file dumped by <span \
class="SpellE"> tcpdump</span>.<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;Compare <span class="SpellE">pcap</span> file \
dumped by <span class="SpellE">dpdk-pdump</span> with <span \
class="SpellE">pcap</span> files dumped by <span \
class="SpellE">tcpdump</span>.<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;Test Case 6: test <span \
class="SpellE">pdump</span> <span class="SpellE"> mbuf</span> size<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; \
&#43;=================================<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;test <span class="SpellE">mbuf</span> size option, set value within \
[252~59520]. min value is<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;decided by single packet size, max value is decided by test platform <span \
class="SpellE">memery</span><o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
size.<o:p></o:p></p> <p class="MsoPlainText">&gt; <o:p></o:p></p>
<p class="MsoPlainText">&gt; Typo issue, should be &quot;memory&quot;.<o:p></o:p></p>
<p class="MsoPlainText">&gt; Should here to verify what will be happened when packet \
size is over <span class="SpellE">mbuf</span> size?<o:p></o:p></p>
<p class="MsoPlainText">[Mo, <span class="SpellE">YufengX</span>] <span \
style="color:#953735;mso-style-textfill-fill-color:#953735;mso-style-textfill-fill-alpha:100.0%">
 when size is <span class="SpellE">beyon</span> the range, <span \
class="SpellE">dpdk-pdump</span> won't boot up. Do you want to add a \
verification.<o:p></o:p></span></p> <p class="MsoPlainText"><span \
style="color:#953735;mso-style-textfill-fill-color:#953735;mso-style-textfill-fill-alpha:100.0%">will \
it do the same verification for other range checking?</span><o:p></o:p></p> <p \
class="MsoPlainText">&gt; Suggest add one case for jumbo frame packet capture, not \
sure whether jumbo frame should be validated here.<o:p></o:p></p> <p \
class="MsoPlainText">[Mo, <span class="SpellE">YufengX</span>] <span \
style="mso-spacerun:yes"> &nbsp;</span><span \
style="color:#953735;mso-style-textfill-fill-color:#953735;mso-style-textfill-fill-alpha:100.0%">Do \
you mean to write a new case for jumbo frame?<o:p></o:p></span></p> <p \
class="MsoPlainText">&gt; <o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;Boot up <span class="SpellE">dpdk's</span> \
<span class="SpellE"> testpmd</span> with chained option::<o:p></o:p></p>
<p class="MsoPlainText"><o:p>&nbsp;</o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-tab-count:1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \
</span>./x86_64-native-linuxapp-gcc/app/<span class="SpellE">testpmd</span> -c 0x6 -n \
4 -- -<span class="SpellE">i</span> --port-<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; topology=chained<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-tab-count:1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">testpmd</span>&gt; set <span class="SpellE">fwd</span> <span \
class="SpellE">io</span><o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-tab-count:1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">testpmd</span>&gt; start<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;When test VLAN_UDP \
type packet transmission, set <span class="SpellE"> vlan</span>:<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">testpmd</span>&gt; <span class="SpellE">vlan</span> set filter off \
1<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">testpmd</span>&gt; start<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;Boot up <span \
class="SpellE">dpdk-pdump</span> with <span class="SpellE"> pdump</span> \
options::<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp; \
</span>./x86_64-native-linuxapp-gcc/app/<span class="SpellE">dpdk-pdump</span> -- \
--<span class="SpellE">pdump</span><o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
'port=0,queue=*,\<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43; <span \
style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp;</span>tx-dev=/tmp/pdump-tx.pcap,rx-dev=/tmp/pdump-rx.pcap,mbuf-size=2048'<o:p></o:p></p>
 <p class="MsoPlainText">&gt; &gt; &#43;<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;Set up <span class="SpellE">linux's</span> \
<span class="SpellE"> tcpdump</span> to receiver packet on tester::<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-tab-count:1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">tcpdump</span> -<span class="SpellE">i</span> &lt;<span \
class="SpellE">rx</span> port name&gt; -w /<span \
class="SpellE">tmp</span>/sniff-&lt;<span class="SpellE">rx</span> port  \
name&gt;.<span class="SpellE">pcap</span><o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;<span style="mso-tab-count:1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">tcpdump</span> -<span class="SpellE">i</span> &lt;<span \
class="SpellE">tx</span> port name&gt; -w /<span \
class="SpellE">tmp</span>/sniff-&lt;<span class="SpellE">tx</span> port  \
name&gt;.<span class="SpellE">pcap</span><o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;Send packet on \
tester by port 0::<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">sendp</span>(&lt;packet format&gt;, <span \
class="SpellE">iface</span>=&lt;port 0 name&gt;)<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;Compare <span class="SpellE">pcap</span> file of <span class="SpellE"> \
scapy</span> with the <span class="SpellE">pcap</span> file dumped by <span \
class="SpellE"> tcpdump</span>.<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;Compare <span class="SpellE">pcap</span> file \
dumped by <span class="SpellE">dpdk-pdump</span> with <span \
class="SpellE">pcap</span> files dumped by <span \
class="SpellE">tcpdump</span>.<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;Send packet on tester by \
port 1::<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">sendp</span>(&lt;packet format&gt;, <span \
class="SpellE">iface</span>=&lt;port 1 name&gt;)<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;Compare <span class="SpellE">pcap</span> file of <span class="SpellE"> \
scapy</span> with the <span class="SpellE">pcap</span> file dumped by <span \
class="SpellE"> tcpdump</span>.<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;Compare <span class="SpellE">pcap</span> file \
dumped by <span class="SpellE">dpdk-pdump</span> with <span \
class="SpellE">pcap</span> files dumped by <span \
class="SpellE">tcpdump</span>.<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;Test Case 7: test <span \
class="SpellE">pdump</span> total <span class="SpellE">num</span> <span \
class="SpellE">mbufs</span><o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;=================================<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;test total-<span class="SpellE">num</span>-<span \
class="SpellE">mbufs</span> option, set value within [1025~65535]<o:p></o:p></p> <p \
class="MsoPlainText">&gt; <o:p></o:p></p> <p class="MsoPlainText">&gt; What will be \
affected when change the number?<span style="mso-spacerun:yes">&nbsp; </span>I think \
<span class="SpellE">mbuf</span> will be freed after packet saved into <span \
class="SpellE">pcap</span> file.<o:p></o:p></p> <p class="MsoPlainText">&gt; Will it \
affect the performance?<o:p></o:p></p> <p class="MsoPlainText">[Mo, <span \
class="SpellE">YufengX</span>] <span \
style="color:#953735;mso-style-textfill-fill-color:#953735;mso-style-textfill-fill-alpha:100.0%">
 no things happen when total-<span class="SpellE">num</span>-<span \
class="SpellE">mbufs</span> changes. Currently, test case will reboot <span \
class="SpellE">dpdk-pdump</span>/<span \
class="SpellE">testpmd</span><o:p></o:p></span></p> <p class="MsoPlainText"><span \
style="color:#953735;mso-style-textfill-fill-color:#953735;mso-style-textfill-fill-alpha:100.0%">after \
each different option finish testing.<o:p></o:p></span></p> <p \
class="MsoPlainText"><span \
style="color:#953735;mso-style-textfill-fill-color:#953735;mso-style-textfill-fill-alpha:100.0%">Within \
those email discussed with <span class="SpellE">Reshma</span>, she has mentioned that \
<span class="SpellE">dpdk-pdump</span> don&#8217;t work for performance, you are are \
in<o:p></o:p></span></p> <p class="MsoPlainText"><span class="SpellE"><span \
style="color:#953735;mso-style-textfill-fill-color:#953735;mso-style-textfill-fill-alpha:100.0%">maillist</span></span><span \
style="color:#953735;mso-style-textfill-fill-color:#953735;mso-style-textfill-fill-alpha:100.0%">
  too.<o:p></o:p></span></p>
<p class="MsoPlainText">&gt; <o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;Boot up <span class="SpellE">dpdk's</span> \
<span class="SpellE"> testpmd</span> with chained option::<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-tab-count:1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \
</span>./x86_64-native-linuxapp-gcc/app/<span class="SpellE">testpmd</span> -c 0x6 -n \
4 -- -<span class="SpellE">i</span> --port-<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; topology=chained<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-tab-count:1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">testpmd</span>&gt; set <span class="SpellE">fwd</span> <span \
class="SpellE">io</span><o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-tab-count:1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">testpmd</span>&gt; start<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;When test VLAN_UDP \
type packet transmission, set <span class="SpellE"> vlan</span>:<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">testpmd</span>&gt; <span class="SpellE">vlan</span> set filter off \
1<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">testpmd</span>&gt; start<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;Boot up <span \
class="SpellE">dpdk-pdump</span> with <span class="SpellE"> pdump</span> \
options::<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp; \
</span>./x86_64-native-linuxapp-gcc/app/<span class="SpellE">dpdk-pdump</span> -- \
--<span class="SpellE">pdump</span><o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
'port=0,queue=*,\<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">tx-dev</span>=/<span class="SpellE">tmp</span>/<span \
class="SpellE">pdump-tx.pcap,rx-dev</span>=/<span class="SpellE">tmp</span>/<span \
class="SpellE">pdump-rx.pcap,total-num</span>-<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; <span class="SpellE">mbufs</span>=8191'<o:p></o:p></p> \
<p class="MsoPlainText">&gt; &gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;Set up <span class="SpellE">linux's</span> <span class="SpellE"> \
tcpdump</span> to receiver packet on tester::<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-tab-count:1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">tcpdump</span> -<span class="SpellE">i</span> &lt;<span \
class="SpellE">rx</span> port name&gt; -w /<span \
class="SpellE">tmp</span>/sniff-&lt;<span class="SpellE">rx</span> port  \
name&gt;.<span class="SpellE">pcap</span><o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;<span style="mso-tab-count:1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">tcpdump</span> -<span class="SpellE">i</span> &lt;<span \
class="SpellE">tx</span> port name&gt; -w /<span \
class="SpellE">tmp</span>/sniff-&lt;<span class="SpellE">tx</span> port  \
name&gt;.<span class="SpellE">pcap</span><o:p></o:p></p> <p class="MsoPlainText">&gt; \
&gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;Send packet on \
tester by port 0::<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">sendp</span>(&lt;packet format&gt;, <span \
class="SpellE">iface</span>=&lt;port 0 name&gt;)<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;Compare <span class="SpellE">pcap</span> file of <span class="SpellE"> \
scapy</span> with the <span class="SpellE">pcap</span> file dumped by <span \
class="SpellE"> tcpdump</span>.<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;Compare <span class="SpellE">pcap</span> file \
dumped by <span class="SpellE">dpdk-pdump</span> with <span \
class="SpellE">pcap</span> files dumped by <span \
class="SpellE">tcpdump</span>.<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;Send packet on tester by \
port 1::<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; &#43;<span \
style="mso-spacerun:yes">&nbsp;&nbsp;&nbsp; </span><span \
class="SpellE">sendp</span>(&lt;packet format&gt;, <span \
class="SpellE">iface</span>=&lt;port 1 name&gt;)<o:p></o:p></p> <p \
class="MsoPlainText">&gt; &gt; &#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;Compare <span class="SpellE">pcap</span> file of <span class="SpellE"> \
scapy</span> with the <span class="SpellE">pcap</span> file dumped by <span \
class="SpellE"> tcpdump</span>.<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; &#43;Compare <span class="SpellE">pcap</span> file \
dumped by <span class="SpellE">dpdk-pdump</span> with <span \
class="SpellE">pcap</span> files dumped by <span \
class="SpellE">tcpdump</span>.<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; \
&#43;<o:p></o:p></p> <p class="MsoPlainText">&gt; &gt; --<o:p></o:p></p>
<p class="MsoPlainText">&gt; &gt; 1.9.3<o:p></o:p></p>
<p class="MsoPlainText"><o:p>&nbsp;</o:p></p>
</div>
</body>
</html>



[prev in list] [next in list] [prev in thread] [next in thread] 

Configure | About | News | Add a list | Sponsored by KoreLogic