Sample Applications User Guides Release 18.11.11 Jan 20, 2021 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 Exception Path Sample Application 11 5.1 Overview........................................ 11 5.2 Compiling the Application............................... 12 5.3 Running the Application................................ 12 5.4 Explanation....................................... 12 6 Hello World Sample Application 16 6.1 Compiling the Application............................... 16 6.2 Running the Application................................ 16 6.3 Explanation....................................... 16 7 Basic Forwarding Sample Application 18 7.1 Compiling the Application............................... 18 7.2 Running the Application................................ 18 7.3 Explanation....................................... 18 8 RX/TX Callbacks Sample Application 23 8.1 Compiling the Application............................... 23 i 8.2 Running the Application................................ 23 8.3 Explanation....................................... 23 9 Flow Classify Sample Application 27 9.1 Compiling the Application............................... 27 9.2 Running the Application................................ 27 9.3 Sample ipv4_rules_file.txt............................... 27 9.4 Explanation....................................... 28 10 Basic RTE Flow Filtering Sample Application 36 10.1 Compiling the Application............................... 36 10.2 Running the Application................................ 36 10.3 Explanation....................................... 36 11 IP Fragmentation Sample Application 44 11.1 Overview........................................ 44 11.2 Compiling the Application............................... 44 11.3 Running the Application................................ 44 12 IPv4 Multicast Sample Application 47 12.1 Overview........................................ 47 12.2 Compiling the Application............................... 47 12.3 Running the Application................................ 48 12.4 Explanation....................................... 48 13 IP Reassembly Sample Application 53 13.1 Overview........................................ 53 13.2 Compiling the Application............................... 53 13.3 Running the Application................................ 53 13.4 Explanation....................................... 55 14 Kernel NIC Interface Sample Application 57 14.1 Overview........................................ 57 14.2 Compiling the Application............................... 58 14.3 Running the kni Example Application........................ 59 14.4 KNI Operations.................................... 60 14.5 Explanation....................................... 61 15 Keep Alive Sample Application 63 15.1 Overview........................................ 63 15.2 Compiling the Application............................... 63 15.3 Running the Application................................ 63 15.4 Explanation....................................... 64 16 L2 Forwarding with Crypto Sample Application 66 16.1 Overview........................................ 66 16.2 Compiling the Application............................... 66 16.3 Running the Application................................ 66 16.4 Explanation....................................... 69 17 L2 Forwarding Sample Application (in Real and Virtualized Environments) with core load statistics. 74 17.1 Overview........................................ 74 ii 17.2 Compiling the Application............................... 76 17.3 Running the Application................................ 76 17.4 Explanation....................................... 76 18 L2 Forwarding Sample Application (in Real and Virtualized Environments) 84 18.1 Overview........................................ 84 18.2 Compiling the Application............................... 87 18.3 Running the Application................................ 87 18.4 Explanation....................................... 87 19 L2 Forwarding Sample Application with Cache Allocation Technology (CAT) 93 19.1 Compiling the Application............................... 93 19.2 Running the Application................................ 94 19.3 Explanation....................................... 95 20 L3 Forwarding Sample Application 96 20.1 Overview........................................ 96 20.2 Compiling the Application............................... 96 20.3 Running the Application................................ 97 20.4 Explanation....................................... 98 21 L3 Forwarding with Power Management Sample Application 102 21.1 Introduction....................................... 102 21.2 Overview........................................ 102 21.3 Compiling the Application............................... 103 21.4 Running the Application................................ 103 21.5 Explanation....................................... 104 21.6 Empty Poll Mode.................................... 108 22 L3 Forwarding with Access Control Sample Application 110 22.1 Overview........................................ 110 22.2 Compiling the Application............................... 114 22.3 Running the Application................................ 114 22.4 Explanation....................................... 115 23 L3 Forwarding in a Virtualization Environment Sample Application 116 23.1 Overview........................................ 116 23.2 Compiling the Application............................... 116 23.3 Running the Application................................ 117 23.4 Explanation....................................... 117 24 Link Status Interrupt Sample Application 118 24.1 Overview........................................ 118 24.2 Compiling the Application............................... 118 24.3 Running the Application................................ 118 24.4 Explanation....................................... 119 25 Load Balancer Sample Application 125 25.1 Overview........................................ 125 25.2 Compiling the Application............................... 126 25.3 Running the Application................................ 126 25.4 Explanation....................................... 127 iii 26 Server-Node EFD Sample Application 129 26.1 Overview........................................ 129 26.2 Compiling the Application............................... 130 26.3 Running the Application................................ 130 26.4 Explanation....................................... 131 27 Service Cores Sample Application 137 27.1 Compiling the Application............................... 137 27.2 Running the Application................................ 137 27.3 Explanation....................................... 137 28 Multi-process Sample Application 140 28.1 Example Applications................................. 140 29 QoS Metering Sample Application 147 29.1 Overview........................................ 147 29.2 Compiling the Application............................... 147 29.3 Running the Application................................ 147 29.4 Explanation....................................... 148 30 QoS Scheduler Sample Application 150 30.1 Overview........................................ 150 30.2 Compiling the Application............................... 150 30.3 Running the Application................................ 151 30.4 Explanation....................................... 154 31 Quota and Watermark Sample Application 156 31.1 Overview........................................ 156 31.2 Compiling the Application............................... 158 31.3 Running the Application................................ 158 31.4 Code Overview.................................... 159 32 Timer Sample Application 166 32.1 Compiling the Application............................... 166 32.2 Running the Application................................ 166 32.3 Explanation....................................... 166 33 Packet Ordering Application 169 33.1 Overview........................................ 169 33.2 Compiling the Application............................... 169 33.3 Running the Application................................ 169 34 VMDQ and DCB Forwarding Sample Application 171 34.1 Overview........................................ 171 34.2 Compiling the Application............................... 172 34.3 Running the Application................................ 172 34.4 Explanation....................................... 172 35 Vhost Sample Application 176 35.1 Testing steps...................................... 176 35.2 Inject packets..................................... 177 35.3 Parameters......................................