1ac718398SBernard Iremonger.. BSD LICENSE 2ac718398SBernard Iremonger Copyright(c) 2010-2014 Intel Corporation. All rights reserved. 3ac718398SBernard Iremonger All rights reserved. 4ac718398SBernard Iremonger 5ac718398SBernard Iremonger Redistribution and use in source and binary forms, with or without 6ac718398SBernard Iremonger modification, are permitted provided that the following conditions 7ac718398SBernard Iremonger are met: 8ac718398SBernard Iremonger 9ac718398SBernard Iremonger * Redistributions of source code must retain the above copyright 10ac718398SBernard Iremonger notice, this list of conditions and the following disclaimer. 11ac718398SBernard Iremonger * Redistributions in binary form must reproduce the above copyright 12ac718398SBernard Iremonger notice, this list of conditions and the following disclaimer in 13ac718398SBernard Iremonger the documentation and/or other materials provided with the 14ac718398SBernard Iremonger distribution. 15ac718398SBernard Iremonger * Neither the name of Intel Corporation nor the names of its 16ac718398SBernard Iremonger contributors may be used to endorse or promote products derived 17ac718398SBernard Iremonger from this software without specific prior written permission. 18ac718398SBernard Iremonger 19ac718398SBernard Iremonger THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 20ac718398SBernard Iremonger "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 21ac718398SBernard Iremonger LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 22ac718398SBernard Iremonger A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 23ac718398SBernard Iremonger OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 24ac718398SBernard Iremonger SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 25ac718398SBernard Iremonger LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 26ac718398SBernard Iremonger DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 27ac718398SBernard Iremonger THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 28ac718398SBernard Iremonger (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 29ac718398SBernard Iremonger OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 30ac718398SBernard Iremonger 31ac718398SBernard IremongerIntroduction 32ac718398SBernard Iremonger============ 33ac718398SBernard Iremonger 34*e76d7a76SJohn McNamaraThis document is a user guide for the ``testpmd`` example application that is shipped as part of the Data Plane Development Kit. 35ac718398SBernard Iremonger 36*e76d7a76SJohn McNamaraThe ``testpmd`` application can be used to test the DPDK in a packet forwarding mode 37ac718398SBernard Iremongerand also to access NIC hardware features such as Flow Director. 38bd89cca3SSiobhan ButlerIt also serves as a example of how to build a more fully-featured application using the DPDK SDK. 39ac718398SBernard Iremonger 40*e76d7a76SJohn McNamaraThe guide shows how to build and run the testpmd application and 41*e76d7a76SJohn McNamarahow to configure the application from the command line and the run-time environment. 42