]> The Tcpdump Group git mirrors - libpcap/blob - pcap-dpdk.c
Don't explicitly check for root permission.
[libpcap] / pcap-dpdk.c
1 /*
2 * Copyright (C) 2018 jingle YANG. All rights reserved.
3 *
4 * Redistribution and use in source and binary forms, with or without
5 * modification, are permitted provided that the following conditions
6 * are met:
7 *
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in the
12 * documentation and/or other materials provided with the distribution.
13 *
14 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS''AND
15 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24 * SUCH DAMAGE.
25 */
26
27 /*
28 Date: Dec 16, 2018
29
30 Description:
31 1. Pcap-dpdk provides libpcap the ability to use DPDK with the device name as dpdk:{portid}, such as dpdk:0.
32 2. DPDK is a set of libraries and drivers for fast packet processing. (https://www.dpdk.org/)
33 3. The testprogs/capturetest provides 6.4Gbps/800,000 pps on Intel 10-Gigabit X540-AT2 with DPDK 18.11.
34
35 Limitations:
36 1. DPDK support will be on if DPDK is available. Please set DIR for --with-dpdk[=DIR] with ./configure or -DDPDK_DIR[=DIR] with cmake if DPDK is installed manually.
37 2. Only support link libdpdk.so dynamicly, because the libdpdk.a will not work correctly.
38 3. Only support read operation, and packet injection has not been supported yet.
39
40 Usage:
41 1. Compile DPDK as shared library and install.(https://github.com/DPDK/dpdk.git)
42
43 You shall modify the file $RTE_SDK/$RTE_TARGET/.config and set:
44 CONFIG_RTE_BUILD_SHARED_LIB=y
45 By the following command:
46 sed -i 's/CONFIG_RTE_BUILD_SHARED_LIB=n/CONFIG_RTE_BUILD_SHARED_LIB=y/' $RTE_SDK/$RTE_TARGET/.config
47
48 2. Launch l2fwd that is one of DPDK examples correctly, and get device information.
49
50 You shall learn how to bind nic with DPDK-compatible driver by $RTE_SDK/usertools/dpdk-devbind.py, such as igb_uio.
51 And enable hugepages by dpdk-setup.sh
52
53 Then launch the l2fwd with dynamic dirver support. For example:
54 $RTE_SDK/examples/l2fwd/$RTE_TARGET/l2fwd -dlibrte_pmd_e1000.so -dlibrte_pmd_ixgbe.so -dlibrte_mempool_ring.so -- -p 0x1
55
56 3. Compile libpcap with dpdk options.
57
58 If DPDK has not been found automatically, you shall export DPDK envionment variable which are used for compiling DPDK. And then pass $RTE_SDK/$RTE_TARGET to --with-dpdk or -DDPDK_DIR
59
60 export RTE_SDK={your DPDK base directory}
61 export RTE_TARGET={your target name}
62
63 3.1 With configure
64
65 ./configure --with-dpdk=$RTE_SDK/$RTE_TARGET && make -s all && make -s testprogs && make install
66
67 3.2 With cmake
68
69 mkdir -p build && cd build && cmake -DDPDK_DIR=$RTE_SDK/$RTE_TARGET ../ && make -s all && make -s testprogs && make install
70
71 4. Link your own program with libpcap, and use DPDK with the device name as dpdk:{portid}, such as dpdk:0.
72 And you shall set DPDK configure options by environment variable DPDK_CFG
73 For example, the testprogs/capturetest could be lanched by:
74
75 env DPDK_CFG="--log-level=debug -l0 -dlibrte_pmd_e1000.so -dlibrte_pmd_ixgbe.so -dlibrte_mempool_ring.so" ./capturetest -i dpdk:0
76 */
77
78 #ifdef HAVE_CONFIG_H
79 #include <config.h>
80 #endif
81
82 #include <ctype.h>
83 #include <errno.h>
84 #include <netdb.h>
85 #include <stdio.h>
86 #include <stdlib.h>
87 #include <string.h>
88 #include <unistd.h>
89 #include <time.h>
90
91 #include <sys/time.h>
92
93 //header for calling dpdk
94 #include <rte_config.h>
95 #include <rte_common.h>
96 #include <rte_errno.h>
97 #include <rte_log.h>
98 #include <rte_malloc.h>
99 #include <rte_memory.h>
100 #include <rte_eal.h>
101 #include <rte_launch.h>
102 #include <rte_atomic.h>
103 #include <rte_cycles.h>
104 #include <rte_lcore.h>
105 #include <rte_per_lcore.h>
106 #include <rte_branch_prediction.h>
107 #include <rte_interrupts.h>
108 #include <rte_random.h>
109 #include <rte_debug.h>
110 #include <rte_ether.h>
111 #include <rte_ethdev.h>
112 #include <rte_mempool.h>
113 #include <rte_mbuf.h>
114 #include <rte_bus.h>
115
116 #include "pcap-int.h"
117 #include "pcap-dpdk.h"
118
119 #define DPDK_DEF_LOG_LEV RTE_LOG_ERR
120 //
121 // This is set to 0 if we haven't initialized DPDK yet, 1 if we've
122 // successfully initialized it, a negative value, which is the negative
123 // of the rte_errno from rte_eal_init(), if we tried to initialize it
124 // and got an error.
125 //
126 static int is_dpdk_pre_inited=0;
127 #define DPDK_LIB_NAME "libpcap_dpdk"
128 #define DPDK_DESC "Data Plane Development Kit (DPDK) Interface"
129 #define DPDK_ERR_PERM_MSG "permission denied, DPDK needs root permission"
130 #define DPDK_ARGC_MAX 64
131 #define DPDK_CFG_MAX_LEN 1024
132 #define DPDK_DEV_NAME_MAX 32
133 #define DPDK_DEV_DESC_MAX 512
134 #define DPDK_CFG_ENV_NAME "DPDK_CFG"
135 #define DPDK_DEF_MIN_SLEEP_MS 1
136 static char dpdk_cfg_buf[DPDK_CFG_MAX_LEN];
137 #define DPDK_MAC_ADDR_SIZE 32
138 #define DPDK_DEF_MAC_ADDR "00:00:00:00:00:00"
139 #define DPDK_PCI_ADDR_SIZE 16
140 #define DPDK_DEF_CFG "--log-level=error -l0 -dlibrte_pmd_e1000.so -dlibrte_pmd_ixgbe.so -dlibrte_mempool_ring.so"
141 #define DPDK_PREFIX "dpdk:"
142 #define DPDK_PORTID_MAX 65535U
143 #define MBUF_POOL_NAME "mbuf_pool"
144 #define DPDK_TX_BUF_NAME "tx_buffer"
145 //The number of elements in the mbuf pool.
146 #define DPDK_NB_MBUFS 8192U
147 #define MEMPOOL_CACHE_SIZE 256
148 #define MAX_PKT_BURST 32
149 // Configurable number of RX/TX ring descriptors
150 #define RTE_TEST_RX_DESC_DEFAULT 1024
151 #define RTE_TEST_TX_DESC_DEFAULT 1024
152
153 static uint16_t nb_rxd = RTE_TEST_RX_DESC_DEFAULT;
154 static uint16_t nb_txd = RTE_TEST_TX_DESC_DEFAULT;
155
156 #define RTE_ETH_PCAP_SNAPLEN ETHER_MAX_JUMBO_FRAME_LEN
157
158 static struct rte_eth_dev_tx_buffer *tx_buffer;
159
160 struct dpdk_ts_helper{
161 struct timeval start_time;
162 uint64_t start_cycles;
163 uint64_t hz;
164 };
165 struct pcap_dpdk{
166 pcap_t * orig;
167 uint16_t portid; // portid of DPDK
168 int must_clear_promisc;
169 uint64_t bpf_drop;
170 int nonblock;
171 struct timeval required_select_timeout;
172 struct timeval prev_ts;
173 struct rte_eth_stats prev_stats;
174 struct timeval curr_ts;
175 struct rte_eth_stats curr_stats;
176 uint64_t pps;
177 uint64_t bps;
178 struct rte_mempool * pktmbuf_pool;
179 struct dpdk_ts_helper ts_helper;
180 struct ether_addr eth_addr;
181 char mac_addr[DPDK_MAC_ADDR_SIZE];
182 char pci_addr[DPDK_PCI_ADDR_SIZE];
183 unsigned char pcap_tmp_buf[RTE_ETH_PCAP_SNAPLEN];
184 };
185
186 static struct rte_eth_conf port_conf = {
187 .rxmode = {
188 .split_hdr_size = 0,
189 },
190 .txmode = {
191 .mq_mode = ETH_MQ_TX_NONE,
192 },
193 };
194
195 static void dpdk_fmt_errmsg_for_rte_errno(char *, size_t, int,
196 PCAP_FORMAT_STRING(const char *), ...) PCAP_PRINTFLIKE(4, 5);
197
198 /*
199 * Generate an error message based on a format, arguments, and an
200 * rte_errno, with a message for the rte_errno after the formatted output.
201 */
202 static void dpdk_fmt_errmsg_for_rte_errno(char *errbuf, size_t errbuflen,
203 int errnum, const char *fmt, ...)
204 {
205 va_list ap;
206 size_t msglen;
207 char *p;
208 size_t errbuflen_remaining;
209
210 va_start(ap, fmt);
211 pcap_vsnprintf(errbuf, errbuflen, fmt, ap);
212 va_end(ap);
213 msglen = strlen(errbuf);
214
215 /*
216 * Do we have enough space to append ": "?
217 * Including the terminating '\0', that's 3 bytes.
218 */
219 if (msglen + 3 > errbuflen) {
220 /* No - just give them what we've produced. */
221 return;
222 }
223 p = errbuf + msglen;
224 errbuflen_remaining = errbuflen - msglen;
225 *p++ = ':';
226 *p++ = ' ';
227 *p = '\0';
228 msglen += 2;
229 errbuflen_remaining -= 2;
230
231 /*
232 * Now append the string for the error code.
233 * rte_strerror() is thread-safe, at least as of dpdk 18.11,
234 * unlike strerror() - it uses strerror_r() rather than strerror()
235 * for UN*X errno values, and prints to what I assume is a per-thread
236 * buffer (based on the "PER_LCORE" in "RTE_DEFINE_PER_LCORE" used
237 * to declare the buffers statically) for DPDK errors.
238 */
239 pcap_snprintf(p, errbuflen_remaining, "%s", rte_strerror(errnum));
240 }
241
242 static int dpdk_init_timer(struct pcap_dpdk *pd){
243 gettimeofday(&(pd->ts_helper.start_time),NULL);
244 pd->ts_helper.start_cycles = rte_get_timer_cycles();
245 pd->ts_helper.hz = rte_get_timer_hz();
246 if (pd->ts_helper.hz == 0){
247 return -1;
248 }
249 return 0;
250 }
251 static inline void calculate_timestamp(struct dpdk_ts_helper *helper,struct timeval *ts)
252 {
253 uint64_t cycles;
254 // delta
255 struct timeval cur_time;
256 cycles = rte_get_timer_cycles() - helper->start_cycles;
257 cur_time.tv_sec = (time_t)(cycles/helper->hz);
258 cur_time.tv_usec = (suseconds_t)((cycles%helper->hz)*1e6/helper->hz);
259 timeradd(&(helper->start_time), &cur_time, ts);
260 }
261
262 static uint32_t dpdk_gather_data(unsigned char *data, int len, struct rte_mbuf *mbuf)
263 {
264 uint32_t total_len = 0;
265 while (mbuf && (total_len+mbuf->data_len) < len ){
266 rte_memcpy(data+total_len, rte_pktmbuf_mtod(mbuf,void *),mbuf->data_len);
267 total_len+=mbuf->data_len;
268 mbuf=mbuf->next;
269 }
270 return total_len;
271 }
272
273
274 static int dpdk_read_with_timeout(pcap_t *p, uint16_t portid, struct rte_mbuf **pkts_burst, const uint16_t burst_cnt){
275 struct pcap_dpdk *pd = (struct pcap_dpdk*)(p->priv);
276 int nb_rx = 0;
277 int timeout_ms = p->opt.timeout;
278 int sleep_ms = 0;
279 if (pd->nonblock){
280 // In non-blocking mode, just read once, no matter how many packets are captured.
281 nb_rx = (int)rte_eth_rx_burst(pd->portid, 0, pkts_burst, burst_cnt);
282 }else{
283 // In blocking mode, read many times until packets are captured or timeout or break_loop is setted.
284 // if timeout_ms == 0, it may be blocked forever.
285 while (timeout_ms == 0 || sleep_ms < timeout_ms){
286 nb_rx = (int)rte_eth_rx_burst(pd->portid, 0, pkts_burst, burst_cnt);
287 if (nb_rx){ // got packets within timeout_ms
288 break;
289 }else{ // no packet arrives at this round.
290 if (p->break_loop){
291 break;
292 }
293 // sleep for a very short while.
294 // block sleep is the only choice, since usleep() will impact performance dramatically.
295 rte_delay_us_block(DPDK_DEF_MIN_SLEEP_MS*1000);
296 sleep_ms += DPDK_DEF_MIN_SLEEP_MS;
297 }
298 }
299 }
300 return nb_rx;
301 }
302
303 static int pcap_dpdk_dispatch(pcap_t *p, int max_cnt, pcap_handler cb, u_char *cb_arg)
304 {
305 struct pcap_dpdk *pd = (struct pcap_dpdk*)(p->priv);
306 int burst_cnt = 0;
307 int nb_rx = 0;
308 struct rte_mbuf *pkts_burst[MAX_PKT_BURST];
309 struct rte_mbuf *m;
310 struct pcap_pkthdr pcap_header;
311 uint16_t portid = pd->portid;
312 // In DPDK, pkt_len is sum of lengths for all segments. And data_len is for one segment
313 uint32_t pkt_len = 0;
314 uint32_t caplen = 0;
315 u_char *bp = NULL;
316 int i=0;
317 unsigned int gather_len =0;
318 int pkt_cnt = 0;
319 u_char *large_buffer=NULL;
320 int timeout_ms = p->opt.timeout;
321
322 if ( !PACKET_COUNT_IS_UNLIMITED(max_cnt) && max_cnt < MAX_PKT_BURST){
323 burst_cnt = max_cnt;
324 }else{
325 burst_cnt = MAX_PKT_BURST;
326 }
327
328 while( PACKET_COUNT_IS_UNLIMITED(max_cnt) || pkt_cnt < max_cnt){
329 if (p->break_loop){
330 p->break_loop = 0;
331 return PCAP_ERROR_BREAK;
332 }
333 // read once in non-blocking mode, or try many times waiting for timeout_ms.
334 // if timeout_ms == 0, it will be blocked until one packet arrives or break_loop is setted.
335 nb_rx = dpdk_read_with_timeout(p, portid, pkts_burst, burst_cnt);
336 if (nb_rx == 0){
337 if (pd->nonblock){
338 RTE_LOG(DEBUG, USER1, "dpdk: no packets available in non-blocking mode.\n");
339 }else{
340 if (p->break_loop){
341 RTE_LOG(DEBUG, USER1, "dpdk: no packets available and break_loop is setted in blocking mode.\n");
342 p->break_loop = 0;
343 return PCAP_ERROR_BREAK;
344
345 }
346 RTE_LOG(DEBUG, USER1, "dpdk: no packets available for timeout %d ms in blocking mode.\n", timeout_ms);
347 }
348 // break if dpdk reads 0 packet, no matter in blocking(timeout) or non-blocking mode.
349 break;
350 }
351 pkt_cnt += nb_rx;
352 for ( i = 0; i < nb_rx; i++) {
353 m = pkts_burst[i];
354 calculate_timestamp(&(pd->ts_helper),&(pcap_header.ts));
355 pkt_len = rte_pktmbuf_pkt_len(m);
356 // caplen = min(pkt_len, p->snapshot);
357 // caplen will not be changed, no matter how long the rte_pktmbuf
358 caplen = pkt_len < (uint32_t)p->snapshot ? pkt_len: (uint32_t)p->snapshot;
359 pcap_header.caplen = caplen;
360 pcap_header.len = pkt_len;
361 // volatile prefetch
362 rte_prefetch0(rte_pktmbuf_mtod(m, void *));
363 bp = NULL;
364 if (m->nb_segs == 1)
365 {
366 bp = rte_pktmbuf_mtod(m, u_char *);
367 }else{
368 // use fast buffer pcap_tmp_buf if pkt_len is small, no need to call malloc and free
369 if ( pkt_len <= ETHER_MAX_JUMBO_FRAME_LEN)
370 {
371 gather_len = dpdk_gather_data(pd->pcap_tmp_buf, RTE_ETH_PCAP_SNAPLEN, m);
372 bp = pd->pcap_tmp_buf;
373 }else{
374 // need call free later
375 large_buffer = (u_char *)malloc(caplen*sizeof(u_char));
376 gather_len = dpdk_gather_data(large_buffer, caplen, m);
377 bp = large_buffer;
378 }
379
380 }
381 if (bp){
382 if (p->fcode.bf_insns==NULL || pcap_filter(p->fcode.bf_insns, bp, pcap_header.len, pcap_header.caplen)){
383 cb(cb_arg, &pcap_header, bp);
384 }else{
385 pd->bpf_drop++;
386 }
387 }
388 //free all pktmbuf
389 rte_pktmbuf_free(m);
390 if (large_buffer){
391 free(large_buffer);
392 large_buffer=NULL;
393 }
394 }
395 }
396 return pkt_cnt;
397 }
398
399 static int pcap_dpdk_inject(pcap_t *p, const void *buf _U_, int size _U_)
400 {
401 //not implemented yet
402 pcap_strlcpy(p->errbuf,
403 "dpdk error: Inject function has not been implemented yet",
404 PCAP_ERRBUF_SIZE);
405 return PCAP_ERROR;
406 }
407
408 static void pcap_dpdk_close(pcap_t *p)
409 {
410 struct pcap_dpdk *pd = p->priv;
411 if (pd==NULL)
412 {
413 return;
414 }
415 if (pd->must_clear_promisc)
416 {
417 rte_eth_promiscuous_disable(pd->portid);
418 }
419 rte_eth_dev_stop(pd->portid);
420 rte_eth_dev_close(pd->portid);
421 pcap_cleanup_live_common(p);
422 }
423
424 static void nic_stats_display(struct pcap_dpdk *pd)
425 {
426 uint16_t portid = pd->portid;
427 struct rte_eth_stats stats;
428 rte_eth_stats_get(portid, &stats);
429 RTE_LOG(INFO,USER1, "portid:%d, RX-packets: %-10"PRIu64" RX-errors: %-10"PRIu64
430 " RX-bytes: %-10"PRIu64" RX-Imissed: %-10"PRIu64"\n", portid, stats.ipackets, stats.ierrors,
431 stats.ibytes,stats.imissed);
432 RTE_LOG(INFO,USER1, "portid:%d, RX-PPS: %-10"PRIu64" RX-Mbps: %.2lf\n", portid, pd->pps, pd->bps/1e6f );
433 }
434
435 static int pcap_dpdk_stats(pcap_t *p, struct pcap_stat *ps)
436 {
437 struct pcap_dpdk *pd = p->priv;
438 calculate_timestamp(&(pd->ts_helper), &(pd->curr_ts));
439 rte_eth_stats_get(pd->portid,&(pd->curr_stats));
440 if (ps){
441 ps->ps_recv = pd->curr_stats.ipackets;
442 ps->ps_drop = pd->curr_stats.ierrors;
443 ps->ps_drop += pd->bpf_drop;
444 ps->ps_ifdrop = pd->curr_stats.imissed;
445 }
446 uint64_t delta_pkt = pd->curr_stats.ipackets - pd->prev_stats.ipackets;
447 struct timeval delta_tm;
448 timersub(&(pd->curr_ts),&(pd->prev_ts), &delta_tm);
449 uint64_t delta_usec = delta_tm.tv_sec*1e6+delta_tm.tv_usec;
450 uint64_t delta_bit = (pd->curr_stats.ibytes-pd->prev_stats.ibytes)*8;
451 RTE_LOG(DEBUG, USER1, "delta_usec: %-10"PRIu64" delta_pkt: %-10"PRIu64" delta_bit: %-10"PRIu64"\n", delta_usec, delta_pkt, delta_bit);
452 pd->pps = (uint64_t)(delta_pkt*1e6f/delta_usec);
453 pd->bps = (uint64_t)(delta_bit*1e6f/delta_usec);
454 nic_stats_display(pd);
455 pd->prev_stats = pd->curr_stats;
456 pd->prev_ts = pd->curr_ts;
457 return 0;
458 }
459
460 static int pcap_dpdk_setnonblock(pcap_t *p, int nonblock){
461 struct pcap_dpdk *pd = (struct pcap_dpdk*)(p->priv);
462 pd->nonblock = nonblock;
463 return 0;
464 }
465
466 static int pcap_dpdk_getnonblock(pcap_t *p){
467 struct pcap_dpdk *pd = (struct pcap_dpdk*)(p->priv);
468 return pd->nonblock;
469 }
470 static int check_link_status(uint16_t portid, struct rte_eth_link *plink)
471 {
472 // wait up to 9 seconds to get link status
473 rte_eth_link_get(portid, plink);
474 return plink->link_status == ETH_LINK_UP;
475 }
476 static void eth_addr_str(struct ether_addr *addrp, char* mac_str, int len)
477 {
478 int offset=0;
479 if (addrp == NULL){
480 pcap_snprintf(mac_str, len-1, DPDK_DEF_MAC_ADDR);
481 return;
482 }
483 for (int i=0; i<6; i++)
484 {
485 if (offset >= len)
486 { // buffer overflow
487 return;
488 }
489 if (i==0)
490 {
491 pcap_snprintf(mac_str+offset, len-1-offset, "%02X",addrp->addr_bytes[i]);
492 offset+=2; // FF
493 }else{
494 pcap_snprintf(mac_str+offset, len-1-offset, ":%02X", addrp->addr_bytes[i]);
495 offset+=3; // :FF
496 }
497 }
498 return;
499 }
500 // return portid by device name, otherwise return -1
501 static uint16_t portid_by_device(char * device)
502 {
503 uint16_t ret = DPDK_PORTID_MAX;
504 int len = strlen(device);
505 int prefix_len = strlen(DPDK_PREFIX);
506 unsigned long ret_ul = 0L;
507 char *pEnd;
508 if (len<=prefix_len || strncmp(device, DPDK_PREFIX, prefix_len)) // check prefix dpdk:
509 {
510 return ret;
511 }
512 //check all chars are digital
513 for (int i=prefix_len; device[i]; i++){
514 if (device[i]<'0' || device[i]>'9'){
515 return ret;
516 }
517 }
518 ret_ul = strtoul(&(device[prefix_len]), &pEnd, 10);
519 if (pEnd == &(device[prefix_len]) || *pEnd != '\0'){
520 return ret;
521 }
522 // too large for portid
523 if (ret_ul >= DPDK_PORTID_MAX){
524 return ret;
525 }
526 ret = (uint16_t)ret_ul;
527 return ret;
528 }
529
530 static int parse_dpdk_cfg(char* dpdk_cfg,char** dargv)
531 {
532 int cnt=0;
533 memset(dargv,0,sizeof(dargv[0])*DPDK_ARGC_MAX);
534 //current process name
535 int skip_space = 1;
536 int i=0;
537 RTE_LOG(INFO, USER1,"dpdk cfg: %s\n",dpdk_cfg);
538 // find first non space char
539 // The last opt is NULL
540 for (i=0;dpdk_cfg[i] && cnt<DPDK_ARGC_MAX-1;i++){
541 if (skip_space && dpdk_cfg[i]!=' '){ // not space
542 skip_space=!skip_space; // skip normal char
543 dargv[cnt++] = dpdk_cfg+i;
544 }
545 if (!skip_space && dpdk_cfg[i]==' '){ // fint a space
546 dpdk_cfg[i]=0x00; // end of this opt
547 skip_space=!skip_space; // skip space char
548 }
549 }
550 dargv[cnt]=NULL;
551 return cnt;
552 }
553
554 // only called once
555 // Returns:
556 //
557 // 1 on success;
558 //
559 // 0 if "the EAL cannot initialize on this system", which we treat as
560 // meaning "DPDK isn't available";
561 //
562 // a PCAP_ERROR_ code for other errors.
563 static int dpdk_pre_init(char * ebuf)
564 {
565 int dargv_cnt=0;
566 char *dargv[DPDK_ARGC_MAX];
567 char *ptr_dpdk_cfg = NULL;
568 int ret;
569 // globale var
570 if (is_dpdk_pre_inited != 0)
571 {
572 // already inited; did that succeed?
573 if (is_dpdk_pre_inited < 0)
574 {
575 // failed
576 goto error;
577 }
578 else
579 {
580 // succeeded
581 return 1;
582 }
583 }
584 // init EAL
585 ptr_dpdk_cfg = getenv(DPDK_CFG_ENV_NAME);
586 // set default log level to debug
587 rte_log_set_global_level(DPDK_DEF_LOG_LEV);
588 if (ptr_dpdk_cfg == NULL)
589 {
590 RTE_LOG(INFO,USER1,"env $DPDK_CFG is unset, so using default: %s\n",DPDK_DEF_CFG);
591 ptr_dpdk_cfg = DPDK_DEF_CFG;
592 }
593 memset(dpdk_cfg_buf,0,sizeof(dpdk_cfg_buf));
594 snprintf(dpdk_cfg_buf,DPDK_CFG_MAX_LEN-1,"%s %s",DPDK_LIB_NAME,ptr_dpdk_cfg);
595 dargv_cnt = parse_dpdk_cfg(dpdk_cfg_buf,dargv);
596 ret = rte_eal_init(dargv_cnt,dargv);
597 if (ret == -1)
598 {
599 // Indicate that we've called rte_eal_init() by setting
600 // is_dpdk_pre_inited to the negative of the error code,
601 // and process the error.
602 is_dpdk_pre_inited = -rte_errno;
603 goto error;
604 }
605 // init succeeded, so we do not need to do it again later.
606 is_dpdk_pre_inited = 1;
607 return 1;
608
609 error:
610 switch (-is_dpdk_pre_inited)
611 {
612 case EACCES:
613 // This "indicates a permissions issue.".
614 RTE_LOG(ERR, USER1, "%s\n", DPDK_ERR_PERM_MSG);
615 pcap_snprintf(ebuf, PCAP_ERRBUF_SIZE,
616 "DPDK requires that it run as root");
617 return PCAP_ERROR_PERM_DENIED;
618
619 case EAGAIN:
620 // This "indicates either a bus or system
621 // resource was not available, setup may
622 // be attempted again."
623 // There's no such error in pcap, so I'm
624 // not sure what we should do here.
625 pcap_snprintf(ebuf, PCAP_ERRBUF_SIZE,
626 "Bus or system resource was not available");
627 break;
628
629 case EALREADY:
630 // This "indicates that the rte_eal_init
631 // function has already been called, and
632 // cannot be called again."
633 // That's not an error; set the "we've
634 // been here before" flag and return
635 // success.
636 is_dpdk_pre_inited = 1;
637 return 1;
638
639 case EFAULT:
640 // This "indicates the tailq configuration
641 // name was not found in memory configuration."
642 pcap_snprintf(ebuf, PCAP_ERRBUF_SIZE,
643 "The tailq configuration name was not found in the memory configuration");
644 return PCAP_ERROR;
645
646 case EINVAL:
647 // This "indicates invalid parameters were
648 // passed as argv/argc." Those came from
649 // the configuration file.
650 pcap_snprintf(ebuf, PCAP_ERRBUF_SIZE,
651 "The configuration file has invalid parameters");
652 break;
653
654 case ENOMEM:
655 // This "indicates failure likely caused by
656 // an out-of-memory condition."
657 pcap_snprintf(ebuf, PCAP_ERRBUF_SIZE,
658 "Out of memory");
659 break;
660
661 case ENODEV:
662 // This "indicates memory setup issues."
663 pcap_snprintf(ebuf, PCAP_ERRBUF_SIZE,
664 "An error occurred setting up memory");
665 break;
666
667 case ENOTSUP:
668 // This "indicates that the EAL cannot
669 // initialize on this system." We treat
670 // that as meaning DPDK isn't available
671 // on this machine, rather than as a
672 // fatal error, and let our caller decide
673 // whether that's a fatal error (if trying
674 // to activate a DPDK device) or not (if
675 // trying to enumerate devices).
676 return 0;
677
678 case EPROTO:
679 // This "indicates that the PCI bus is
680 // either not present, or is not readable
681 // by the eal." Does "the PCI bus is not
682 // present" mean "this machine has no PCI
683 // bus", which strikes me as a "not available"
684 // case? If so, should "is not readable by
685 // the EAL" also something we should treat
686 // as a "not available" case? If not, we
687 // can't distinguish between the two, so
688 // we're stuck.
689 pcap_snprintf(ebuf, PCAP_ERRBUF_SIZE,
690 "PCI bus is not present or not readable by the EAL");
691 break;
692
693 case ENOEXEC:
694 // This "indicates that a service core
695 // failed to launch successfully."
696 pcap_snprintf(ebuf, PCAP_ERRBUF_SIZE,
697 "A service core failed to launch successfully");
698 break;
699
700 default:
701 //
702 // That's not in the list of errors in
703 // the documentation; let it be reported
704 // as an error.
705 //
706 dpdk_fmt_errmsg_for_rte_errno(ebuf,
707 PCAP_ERRBUF_SIZE, -is_dpdk_pre_inited,
708 "dpdk error: dpdk_pre_init failed");
709 break;
710 }
711 // Error.
712 return PCAP_ERROR;
713 }
714
715 static int pcap_dpdk_activate(pcap_t *p)
716 {
717 struct pcap_dpdk *pd = p->priv;
718 pd->orig = p;
719 int ret = PCAP_ERROR;
720 uint16_t nb_ports=0;
721 uint16_t portid= DPDK_PORTID_MAX;
722 unsigned nb_mbufs = DPDK_NB_MBUFS;
723 struct rte_eth_rxconf rxq_conf;
724 struct rte_eth_txconf txq_conf;
725 struct rte_eth_conf local_port_conf = port_conf;
726 struct rte_eth_dev_info dev_info;
727 int is_port_up = 0;
728 struct rte_eth_link link;
729 do{
730 //init EAL
731 char dpdk_pre_init_errbuf[PCAP_ERRBUF_SIZE];
732 ret = dpdk_pre_init(dpdk_pre_init_errbuf);
733 if (ret < 0)
734 {
735 // This returns a negative value on an error.
736 pcap_snprintf(p->errbuf, PCAP_ERRBUF_SIZE,
737 "Can't open device %s: %s",
738 p->opt.device, dpdk_pre_init_errbuf);
739 // ret is set to the correct error
740 break;
741 }
742 if (ret == 0)
743 {
744 // This means DPDK isn't available on this machine.
745 pcap_snprintf(p->errbuf, PCAP_ERRBUF_SIZE,
746 "Can't open device %s: DPDK is not available on this machine",
747 p->opt.device);
748 return PCAP_ERROR_NO_SUCH_DEVICE;
749 }
750
751 ret = dpdk_init_timer(pd);
752 if (ret<0)
753 {
754 pcap_snprintf(p->errbuf, PCAP_ERRBUF_SIZE,
755 "dpdk error: Init timer is zero with device %s",
756 p->opt.device);
757 ret = PCAP_ERROR;
758 break;
759 }
760
761 nb_ports = rte_eth_dev_count_avail();
762 if (nb_ports == 0)
763 {
764 pcap_snprintf(p->errbuf, PCAP_ERRBUF_SIZE,
765 "dpdk error: No Ethernet ports");
766 ret = PCAP_ERROR;
767 break;
768 }
769
770 portid = portid_by_device(p->opt.device);
771 if (portid == DPDK_PORTID_MAX){
772 pcap_snprintf(p->errbuf, PCAP_ERRBUF_SIZE,
773 "dpdk error: portid is invalid. device %s",
774 p->opt.device);
775 ret = PCAP_ERROR_NO_SUCH_DEVICE;
776 break;
777 }
778
779 pd->portid = portid;
780
781 if (p->snapshot <= 0 || p->snapshot > MAXIMUM_SNAPLEN)
782 {
783 p->snapshot = MAXIMUM_SNAPLEN;
784 }
785 // create the mbuf pool
786 pd->pktmbuf_pool = rte_pktmbuf_pool_create(MBUF_POOL_NAME, nb_mbufs,
787 MEMPOOL_CACHE_SIZE, 0, RTE_MBUF_DEFAULT_BUF_SIZE,
788 rte_socket_id());
789 if (pd->pktmbuf_pool == NULL)
790 {
791 dpdk_fmt_errmsg_for_rte_errno(p->errbuf,
792 PCAP_ERRBUF_SIZE, rte_errno,
793 "dpdk error: Cannot init mbuf pool");
794 ret = PCAP_ERROR;
795 break;
796 }
797 // config dev
798 rte_eth_dev_info_get(portid, &dev_info);
799 if (dev_info.tx_offload_capa & DEV_TX_OFFLOAD_MBUF_FAST_FREE)
800 {
801 local_port_conf.txmode.offloads |=DEV_TX_OFFLOAD_MBUF_FAST_FREE;
802 }
803 // only support 1 queue
804 ret = rte_eth_dev_configure(portid, 1, 1, &local_port_conf);
805 if (ret < 0)
806 {
807 dpdk_fmt_errmsg_for_rte_errno(p->errbuf,
808 PCAP_ERRBUF_SIZE, -ret,
809 "dpdk error: Cannot configure device: port=%u",
810 portid);
811 ret = PCAP_ERROR;
812 break;
813 }
814 // adjust rx tx
815 ret = rte_eth_dev_adjust_nb_rx_tx_desc(portid, &nb_rxd, &nb_txd);
816 if (ret < 0)
817 {
818 dpdk_fmt_errmsg_for_rte_errno(p->errbuf,
819 PCAP_ERRBUF_SIZE, -ret,
820 "dpdk error: Cannot adjust number of descriptors: port=%u",
821 portid);
822 ret = PCAP_ERROR;
823 break;
824 }
825 // get MAC addr
826 rte_eth_macaddr_get(portid, &(pd->eth_addr));
827 eth_addr_str(&(pd->eth_addr), pd->mac_addr, DPDK_MAC_ADDR_SIZE-1);
828
829 // init one RX queue
830 rxq_conf = dev_info.default_rxconf;
831 rxq_conf.offloads = local_port_conf.rxmode.offloads;
832 ret = rte_eth_rx_queue_setup(portid, 0, nb_rxd,
833 rte_eth_dev_socket_id(portid),
834 &rxq_conf,
835 pd->pktmbuf_pool);
836 if (ret < 0)
837 {
838 dpdk_fmt_errmsg_for_rte_errno(p->errbuf,
839 PCAP_ERRBUF_SIZE, -ret,
840 "dpdk error: rte_eth_rx_queue_setup:port=%u",
841 portid);
842 ret = PCAP_ERROR;
843 break;
844 }
845
846 // init one TX queue
847 txq_conf = dev_info.default_txconf;
848 txq_conf.offloads = local_port_conf.txmode.offloads;
849 ret = rte_eth_tx_queue_setup(portid, 0, nb_txd,
850 rte_eth_dev_socket_id(portid),
851 &txq_conf);
852 if (ret < 0)
853 {
854 dpdk_fmt_errmsg_for_rte_errno(p->errbuf,
855 PCAP_ERRBUF_SIZE, -ret,
856 "dpdk error: rte_eth_tx_queue_setup:port=%u",
857 portid);
858 ret = PCAP_ERROR;
859 break;
860 }
861 // Initialize TX buffers
862 tx_buffer = rte_zmalloc_socket(DPDK_TX_BUF_NAME,
863 RTE_ETH_TX_BUFFER_SIZE(MAX_PKT_BURST), 0,
864 rte_eth_dev_socket_id(portid));
865 if (tx_buffer == NULL)
866 {
867 pcap_snprintf(p->errbuf, PCAP_ERRBUF_SIZE,
868 "dpdk error: Cannot allocate buffer for tx on port %u", portid);
869 ret = PCAP_ERROR;
870 break;
871 }
872 rte_eth_tx_buffer_init(tx_buffer, MAX_PKT_BURST);
873 // Start device
874 ret = rte_eth_dev_start(portid);
875 if (ret < 0)
876 {
877 dpdk_fmt_errmsg_for_rte_errno(p->errbuf,
878 PCAP_ERRBUF_SIZE, -ret,
879 "dpdk error: rte_eth_dev_start:port=%u",
880 portid);
881 ret = PCAP_ERROR;
882 break;
883 }
884 // set promiscuous mode
885 if (p->opt.promisc){
886 pd->must_clear_promisc=1;
887 rte_eth_promiscuous_enable(portid);
888 }
889 // check link status
890 is_port_up = check_link_status(portid, &link);
891 if (!is_port_up){
892 pcap_snprintf(p->errbuf, PCAP_ERRBUF_SIZE,
893 "dpdk error: link is down, port=%u",portid);
894 ret = PCAP_ERROR_IFACE_NOT_UP;
895 break;
896 }
897 // reset statistics
898 rte_eth_stats_reset(pd->portid);
899 calculate_timestamp(&(pd->ts_helper), &(pd->prev_ts));
900 rte_eth_stats_get(pd->portid,&(pd->prev_stats));
901 // format pcap_t
902 pd->portid = portid;
903 p->fd = pd->portid;
904 if (p->snapshot <=0 || p->snapshot> MAXIMUM_SNAPLEN)
905 {
906 p->snapshot = MAXIMUM_SNAPLEN;
907 }
908 p->linktype = DLT_EN10MB; // Ethernet, the 10MB is historical.
909 p->selectable_fd = p->fd;
910 p->read_op = pcap_dpdk_dispatch;
911 p->inject_op = pcap_dpdk_inject;
912 // using pcap_filter currently, though DPDK provides their own BPF function. Because DPDK BPF needs load a ELF file as a filter.
913 p->setfilter_op = install_bpf_program;
914 p->setdirection_op = NULL;
915 p->set_datalink_op = NULL;
916 p->getnonblock_op = pcap_dpdk_getnonblock;
917 p->setnonblock_op = pcap_dpdk_setnonblock;
918 p->stats_op = pcap_dpdk_stats;
919 p->cleanup_op = pcap_dpdk_close;
920 p->breakloop_op = pcap_breakloop_common;
921 // set default timeout
922 pd->required_select_timeout.tv_sec = 0;
923 pd->required_select_timeout.tv_usec = DPDK_DEF_MIN_SLEEP_MS*1000;
924 p->required_select_timeout = &pd->required_select_timeout;
925 ret = 0; // OK
926 }while(0);
927
928 if (ret <= PCAP_ERROR) // all kinds of error code
929 {
930 pcap_cleanup_live_common(p);
931 }else{
932 rte_eth_dev_get_name_by_port(portid,pd->pci_addr);
933 RTE_LOG(INFO, USER1,"Port %d device: %s, MAC:%s, PCI:%s\n", portid, p->opt.device, pd->mac_addr, pd->pci_addr);
934 RTE_LOG(INFO, USER1,"Port %d Link Up. Speed %u Mbps - %s\n",
935 portid, link.link_speed,
936 (link.link_duplex == ETH_LINK_FULL_DUPLEX) ?
937 ("full-duplex") : ("half-duplex\n"));
938 }
939 return ret;
940 }
941
942 // device name for dpdk shoud be in the form as dpdk:number, such as dpdk:0
943 pcap_t * pcap_dpdk_create(const char *device, char *ebuf, int *is_ours)
944 {
945 pcap_t *p=NULL;
946 *is_ours = 0;
947
948 *is_ours = !strncmp(device, "dpdk:", 5);
949 if (! *is_ours)
950 return NULL;
951 //memset will happen
952 p = pcap_create_common(ebuf, sizeof(struct pcap_dpdk));
953
954 if (p == NULL)
955 return NULL;
956 p->activate_op = pcap_dpdk_activate;
957 return p;
958 }
959
960 int pcap_dpdk_findalldevs(pcap_if_list_t *devlistp, char *ebuf)
961 {
962 int ret=0;
963 unsigned int nb_ports = 0;
964 char dpdk_name[DPDK_DEV_NAME_MAX];
965 char dpdk_desc[DPDK_DEV_DESC_MAX];
966 struct ether_addr eth_addr;
967 char mac_addr[DPDK_MAC_ADDR_SIZE];
968 char pci_addr[DPDK_PCI_ADDR_SIZE];
969 do{
970 char dpdk_pre_init_errbuf[PCAP_ERRBUF_SIZE];
971 ret = dpdk_pre_init(dpdk_pre_init_errbuf);
972 if (ret < 0)
973 {
974 // This returns a negative value on an error.
975 pcap_snprintf(ebuf, PCAP_ERRBUF_SIZE,
976 "Can't look for DPDK devices: %s",
977 dpdk_pre_init_errbuf);
978 ret = PCAP_ERROR;
979 break;
980 }
981 if (ret == 0)
982 {
983 // This means DPDK isn't available on this machine.
984 // That just means "don't return any devices".
985 break;
986 }
987 nb_ports = rte_eth_dev_count_avail();
988 if (nb_ports == 0)
989 {
990 // That just means "don't return any devices".
991 ret = 0;
992 break;
993 }
994 for (unsigned int i=0; i<nb_ports; i++){
995 pcap_snprintf(dpdk_name, DPDK_DEV_NAME_MAX-1,
996 "%s%u", DPDK_PREFIX, i);
997 // mac addr
998 rte_eth_macaddr_get(i, &eth_addr);
999 eth_addr_str(&eth_addr,mac_addr,DPDK_MAC_ADDR_SIZE);
1000 // PCI addr
1001 rte_eth_dev_get_name_by_port(i,pci_addr);
1002 pcap_snprintf(dpdk_desc,DPDK_DEV_DESC_MAX-1,"%s %s, MAC:%s, PCI:%s", DPDK_DESC, dpdk_name, mac_addr, pci_addr);
1003 if (add_dev(devlistp, dpdk_name, 0, dpdk_desc, ebuf)==NULL){
1004 ret = PCAP_ERROR;
1005 break;
1006 }
1007 }
1008 }while(0);
1009 return ret;
1010 }
1011
1012 #ifdef DPDK_ONLY
1013 /*
1014 * This libpcap build supports only DPDK, not regular network interfaces.
1015 */
1016
1017 /*
1018 * There are no regular interfaces, just DPDK interfaces.
1019 */
1020 int
1021 pcap_platform_finddevs(pcap_if_list_t *devlistp _U_, char *errbuf)
1022 {
1023 return (0);
1024 }
1025
1026 /*
1027 * Attempts to open a regular interface fail.
1028 */
1029 pcap_t *
1030 pcap_create_interface(const char *device, char *errbuf)
1031 {
1032 pcap_snprintf(errbuf, PCAP_ERRBUF_SIZE,
1033 "This version of libpcap only supports DPDK");
1034 return NULL;
1035 }
1036
1037 /*
1038 * Libpcap version string.
1039 */
1040 const char *
1041 pcap_lib_version(void)
1042 {
1043 return (PCAP_VERSION_STRING " (DPDK-only)");
1044 }
1045 #endif