Sample Applications User Guides Release 20.05.0 May 26, 2020 CONTENTS 1 Introduction to the DPDK Sample Applications1 1.1 Running Sample Applications...............................1 1.2 The DPDK Sample Applications..............................1 2 Compiling the Sample Applications3 2.1 To compile all the sample applications...........................3 2.2 To compile a single application..............................3 2.3 To cross compile the sample application(s)........................4 3 Command Line Sample Application5 3.1 Overview..........................................5 3.2 Compiling the Application.................................5 3.3 Running the Application..................................6 3.4 Explanation.........................................6 4 Ethtool Sample Application8 4.1 Compiling the Application.................................8 4.2 Running the Application..................................8 4.3 Using the application....................................8 4.4 Explanation.........................................9 4.5 Ethtool interface......................................9 5 Hello World Sample Application 11 5.1 Compiling the Application................................. 11 5.2 Running the Application.................................. 11 5.3 Explanation......................................... 11 6 Basic Forwarding Sample Application 13 6.1 Compiling the Application................................. 13 6.2 Running the Application.................................. 13 6.3 Explanation......................................... 13 7 RX/TX Callbacks Sample Application 18 7.1 Compiling the Application................................. 18 7.2 Running the Application.................................. 18 7.3 Explanation......................................... 18 8 Flow Classify Sample Application 22 8.1 Compiling the Application................................. 22 8.2 Running the Application.................................. 22 i 8.3 Sample ipv4_rules_file.txt................................. 22 8.4 Explanation......................................... 22 9 Basic RTE Flow Filtering Sample Application 31 9.1 Compiling the Application................................. 31 9.2 Running the Application.................................. 31 9.3 Explanation......................................... 31 10 IP Fragmentation Sample Application 39 10.1 Overview.......................................... 39 10.2 Compiling the Application................................. 39 10.3 Running the Application.................................. 39 11 IPv4 Multicast Sample Application 42 11.1 Overview.......................................... 42 11.2 Compiling the Application................................. 42 11.3 Running the Application.................................. 42 11.4 Explanation......................................... 43 12 IP Reassembly Sample Application 47 12.1 Overview.......................................... 47 12.2 Compiling the Application................................. 47 12.3 Running the Application.................................. 47 12.4 Explanation......................................... 49 13 Kernel NIC Interface Sample Application 51 13.1 Overview.......................................... 51 13.2 Compiling the Application................................. 52 13.3 Running the kni Example Application........................... 52 13.4 KNI Operations...................................... 54 13.5 Explanation......................................... 55 14 Keep Alive Sample Application 56 14.1 Overview.......................................... 56 14.2 Compiling the Application................................. 56 14.3 Running the Application.................................. 56 14.4 Explanation......................................... 57 15 Packet copying using Intel® QuickData Technology 59 15.1 Overview.......................................... 59 15.2 Compiling the Application................................. 59 15.3 Running the Application.................................. 59 15.4 Explanation......................................... 60 16 L2 Forwarding with Crypto Sample Application 68 16.1 Overview.......................................... 68 16.2 Compiling the Application................................. 68 16.3 Running the Application.................................. 68 16.4 Explanation......................................... 70 17 L2 Forwarding Sample Application (in Real and Virtualized Environments) with core load statistics. 76 17.1 Overview.......................................... 76 ii 17.2 Compiling the Application................................. 78 17.3 Running the Application.................................. 78 17.4 Explanation......................................... 78 18 L2 Forwarding Sample Application (in Real and Virtualized Environments) 86 18.1 Overview.......................................... 86 18.2 Compiling the Application................................. 89 18.3 Running the Application.................................. 89 18.4 Explanation......................................... 89 19 L2 Forwarding Eventdev Sample Application 95 19.1 Overview.......................................... 95 19.2 Compiling the Application................................. 95 19.3 Running the Application.................................. 95 19.4 Explanation......................................... 97 20 L2 Forwarding Sample Application with Cache Allocation Technology (CAT) 106 20.1 Compiling the Application................................. 106 20.2 Running the Application.................................. 107 20.3 Explanation......................................... 108 21 L3 Forwarding Sample Application 109 21.1 Overview.......................................... 109 21.2 Compiling the Application................................. 109 21.3 Running the Application.................................. 110 21.4 Explanation......................................... 112 22 L3 Forwarding Graph Sample Application 116 22.1 Overview.......................................... 116 22.2 Compiling the Application................................. 116 22.3 Running the Application.................................. 116 22.4 Explanation......................................... 117 23 L3 Forwarding with Power Management Sample Application 122 23.1 Introduction........................................ 122 23.2 Overview.......................................... 122 23.3 Compiling the Application................................. 123 23.4 Running the Application.................................. 123 23.5 Explanation......................................... 124 23.6 Empty Poll Mode...................................... 128 23.7 Telemetry Mode...................................... 129 24 L3 Forwarding with Access Control Sample Application 130 24.1 Overview.......................................... 130 24.2 Compiling the Application................................. 134 24.3 Running the Application.................................. 134 24.4 Explanation......................................... 135 25 Link Status Interrupt Sample Application 136 25.1 Overview.......................................... 136 25.2 Compiling the Application................................. 136 25.3 Running the Application.................................. 136 25.4 Explanation......................................... 137 iii 26 Server-Node EFD Sample Application 143 26.1 Overview.......................................... 143 26.2 Compiling the Application................................. 144 26.3 Running the Application.................................. 144 26.4 Explanation......................................... 145 27 Service Cores Sample Application 151 27.1 Compiling the Application................................. 151 27.2 Running the Application.................................. 151 27.3 Explanation......................................... 151 28 Multi-process Sample Application 154 28.1 Example Applications................................... 154 29 QoS Metering Sample Application 161 29.1 Overview.......................................... 161 29.2 Compiling the Application................................. 161 29.3 Running the Application.................................. 161 29.4 Explanation......................................... 162 30 QoS Scheduler Sample Application 164 30.1 Overview.......................................... 164 30.2 Compiling the Application................................. 164 30.3 Running the Application.................................. 165 30.4 Explanation......................................... 169 31 Timer Sample Application 171 31.1 Compiling the Application................................. 171 31.2 Running the Application.................................. 171 31.3 Explanation......................................... 171 32 Packet Ordering Application 174 32.1 Overview.......................................... 174 32.2 Compiling the Application................................. 174 32.3 Running the Application.................................. 174 33 VMDQ and DCB Forwarding Sample Application 176 33.1 Overview.......................................... 176 33.2 Compiling the Application................................. 177 33.3 Running the Application.................................. 177 33.4 Explanation......................................... 177 34 VMDq Forwarding Sample Application 181 34.1 Overview.......................................... 181 34.2 Compiling the Application................................. 182 34.3 Running