2 * Copyright (C) 2018 jingle YANG. All rights reserved.
4 * Redistribution and use in source and binary forms, with or without
5 * modification, are permitted provided that the following conditions
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.
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
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.
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.
41 1. Compile DPDK as shared library and install.(https://github.com/DPDK/dpdk.git)
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
48 2. Launch l2fwd that is one of DPDK examples correctly, and get device information.
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
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
56 3. Compile libpcap with dpdk options.
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
60 export RTE_SDK={your DPDK base directory}
61 export RTE_TARGET={your target name}
65 ./configure --with-dpdk=$RTE_SDK/$RTE_TARGET && make -s all && make -s testprogs && make install
69 mkdir -p build && cd build && cmake -DDPDK_DIR=$RTE_SDK/$RTE_TARGET ../ && make -s all && make -s testprogs && make install
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:
75 env DPDK_CFG="--log-level=debug -l0 -dlibrte_pmd_e1000.so -dlibrte_pmd_ixgbe.so -dlibrte_mempool_ring.so" ./capturetest -i dpdk:0
93 //header for calling dpdk
94 #include <rte_config.h>
95 #include <rte_common.h>
96 #include <rte_errno.h>
98 #include <rte_malloc.h>
99 #include <rte_memory.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>
116 #include "pcap-int.h"
117 #include "pcap-dpdk.h"
119 #define DPDK_DEF_LOG_LEV RTE_LOG_ERR
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
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
153 static uint16_t nb_rxd
= RTE_TEST_RX_DESC_DEFAULT
;
154 static uint16_t nb_txd
= RTE_TEST_TX_DESC_DEFAULT
;
156 #define RTE_ETH_PCAP_SNAPLEN ETHER_MAX_JUMBO_FRAME_LEN
158 static struct rte_eth_dev_tx_buffer
*tx_buffer
;
160 struct dpdk_ts_helper
{
161 struct timeval start_time
;
162 uint64_t start_cycles
;
167 uint16_t portid
; // portid of DPDK
168 int must_clear_promisc
;
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
;
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
];
186 static struct rte_eth_conf port_conf
= {
191 .mq_mode
= ETH_MQ_TX_NONE
,
195 static void dpdk_fmt_errmsg_for_rte_errno(char *, size_t, int,
196 PCAP_FORMAT_STRING(const char *), ...) PCAP_PRINTFLIKE(4, 5);
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.
202 static void dpdk_fmt_errmsg_for_rte_errno(char *errbuf
, size_t errbuflen
,
203 int errnum
, const char *fmt
, ...)
208 size_t errbuflen_remaining
;
211 pcap_vsnprintf(errbuf
, errbuflen
, fmt
, ap
);
213 msglen
= strlen(errbuf
);
216 * Do we have enough space to append ": "?
217 * Including the terminating '\0', that's 3 bytes.
219 if (msglen
+ 3 > errbuflen
) {
220 /* No - just give them what we've produced. */
224 errbuflen_remaining
= errbuflen
- msglen
;
229 errbuflen_remaining
-= 2;
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.
239 pcap_snprintf(p
, errbuflen_remaining
, "%s", rte_strerror(errnum
));
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){
251 static inline void calculate_timestamp(struct dpdk_ts_helper
*helper
,struct timeval
*ts
)
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
);
262 static uint32_t dpdk_gather_data(unsigned char *data
, int len
, struct rte_mbuf
*mbuf
)
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
;
274 static int dpdk_read_with_timeout(pcap_t
*p
, uint16_t portid
, uint16_t queueid
,struct rte_mbuf
**pkts_burst
, const uint16_t burst_cnt
){
275 struct pcap_dpdk
*pd
= (struct pcap_dpdk
*)(p
->priv
);
277 int timeout_ms
= p
->opt
.timeout
;
280 // In non-blocking mode, just read once, no mater how many packets are captured.
281 nb_rx
= (int)rte_eth_rx_burst(pd
->portid
, 0, pkts_burst
, burst_cnt
);
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
289 }else{ // no packet arrives at this round.
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
;
303 static int pcap_dpdk_dispatch(pcap_t
*p
, int max_cnt
, pcap_handler cb
, u_char
*cb_arg
)
305 struct pcap_dpdk
*pd
= (struct pcap_dpdk
*)(p
->priv
);
308 struct rte_mbuf
*pkts_burst
[MAX_PKT_BURST
];
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;
317 unsigned int gather_len
=0;
320 u_char
*large_buffer
=NULL
;
321 int timeout_ms
= p
->opt
.timeout
;
323 if ( !PACKET_COUNT_IS_UNLIMITED(max_cnt
) && max_cnt
< MAX_PKT_BURST
){
326 burst_cnt
= MAX_PKT_BURST
;
329 while( PACKET_COUNT_IS_UNLIMITED(max_cnt
) || pkt_cnt
< max_cnt
){
332 return PCAP_ERROR_BREAK
;
334 // read once in non-blocking mode, or try many times waiting for timeout_ms.
335 // if timeout_ms == 0, it will be blocked until one packet arrives or break_loop is setted.
336 nb_rx
= dpdk_read_with_timeout(p
, portid
, 0, pkts_burst
, burst_cnt
);
339 RTE_LOG(DEBUG
, USER1
, "dpdk: no packets available in non-blocking mode.\n");
342 RTE_LOG(DEBUG
, USER1
, "dpdk: no packets available and break_loop is setted in blocking mode.\n");
344 return PCAP_ERROR_BREAK
;
347 RTE_LOG(DEBUG
, USER1
, "dpdk: no packets available for timeout %d ms in blocking mode.\n", timeout_ms
);
349 // break if dpdk reads 0 packet, no matter in blocking(timeout) or non-blocking mode.
353 for ( i
= 0; i
< nb_rx
; i
++) {
355 calculate_timestamp(&(pd
->ts_helper
),&(pcap_header
.ts
));
356 pkt_len
= rte_pktmbuf_pkt_len(m
);
357 // caplen = min(pkt_len, p->snapshot);
358 // caplen will not be changed, no matter how long the rte_pktmbuf
359 caplen
= pkt_len
< p
->snapshot
? pkt_len
: p
->snapshot
;
360 pcap_header
.caplen
= caplen
;
361 pcap_header
.len
= pkt_len
;
363 rte_prefetch0(rte_pktmbuf_mtod(m
, void *));
367 bp
= rte_pktmbuf_mtod(m
, u_char
*);
369 // use fast buffer pcap_tmp_buf if pkt_len is small, no need to call malloc and free
370 if ( pkt_len
<= ETHER_MAX_JUMBO_FRAME_LEN
)
372 gather_len
= dpdk_gather_data(pd
->pcap_tmp_buf
, RTE_ETH_PCAP_SNAPLEN
, m
);
373 bp
= pd
->pcap_tmp_buf
;
375 // need call free later
376 large_buffer
= (u_char
*)malloc(caplen
*sizeof(u_char
));
377 gather_len
= dpdk_gather_data(large_buffer
, caplen
, m
);
383 if (p
->fcode
.bf_insns
==NULL
|| pcap_filter(p
->fcode
.bf_insns
, bp
, pcap_header
.len
, pcap_header
.caplen
)){
384 cb(cb_arg
, &pcap_header
, bp
);
400 static int pcap_dpdk_inject(pcap_t
*p
, const void *buf _U_
, int size _U_
)
402 //not implemented yet
403 pcap_strlcpy(p
->errbuf
,
404 "dpdk error: Inject function has not been implemented yet",
409 static void pcap_dpdk_close(pcap_t
*p
)
411 struct pcap_dpdk
*pd
= p
->priv
;
416 if (pd
->must_clear_promisc
)
418 rte_eth_promiscuous_disable(pd
->portid
);
420 rte_eth_dev_stop(pd
->portid
);
421 rte_eth_dev_close(pd
->portid
);
422 pcap_cleanup_live_common(p
);
425 static void nic_stats_display(struct pcap_dpdk
*pd
)
427 uint16_t portid
= pd
->portid
;
428 struct rte_eth_stats stats
;
429 rte_eth_stats_get(portid
, &stats
);
430 RTE_LOG(INFO
,USER1
, "portid:%d, RX-packets: %-10"PRIu64
" RX-errors: %-10"PRIu64
431 " RX-bytes: %-10"PRIu64
" RX-Imissed: %-10"PRIu64
"\n", portid
, stats
.ipackets
, stats
.ierrors
,
432 stats
.ibytes
,stats
.imissed
);
433 RTE_LOG(INFO
,USER1
, "portid:%d, RX-PPS: %-10"PRIu64
" RX-Mbps: %.2lf\n", portid
, pd
->pps
, pd
->bps
/1e6f
);
436 static int pcap_dpdk_stats(pcap_t
*p
, struct pcap_stat
*ps
)
438 struct pcap_dpdk
*pd
= p
->priv
;
439 calculate_timestamp(&(pd
->ts_helper
), &(pd
->curr_ts
));
440 rte_eth_stats_get(pd
->portid
,&(pd
->curr_stats
));
442 ps
->ps_recv
= pd
->curr_stats
.ipackets
;
443 ps
->ps_drop
= pd
->curr_stats
.ierrors
;
444 ps
->ps_drop
+= pd
->bpf_drop
;
445 ps
->ps_ifdrop
= pd
->curr_stats
.imissed
;
447 uint64_t delta_pkt
= pd
->curr_stats
.ipackets
- pd
->prev_stats
.ipackets
;
448 struct timeval delta_tm
;
449 timersub(&(pd
->curr_ts
),&(pd
->prev_ts
), &delta_tm
);
450 uint64_t delta_usec
= delta_tm
.tv_sec
*1e6
+delta_tm
.tv_usec
;
451 uint64_t delta_bit
= (pd
->curr_stats
.ibytes
-pd
->prev_stats
.ibytes
)*8;
452 RTE_LOG(DEBUG
, USER1
, "delta_usec: %-10"PRIu64
" delta_pkt: %-10"PRIu64
" delta_bit: %-10"PRIu64
"\n", delta_usec
, delta_pkt
, delta_bit
);
453 pd
->pps
= (uint64_t)(delta_pkt
*1e6f
/delta_usec
);
454 pd
->bps
= (uint64_t)(delta_bit
*1e6f
/delta_usec
);
455 nic_stats_display(pd
);
456 pd
->prev_stats
= pd
->curr_stats
;
457 pd
->prev_ts
= pd
->curr_ts
;
461 static int pcap_dpdk_setnonblock(pcap_t
*p
, int nonblock
){
462 struct pcap_dpdk
*pd
= (struct pcap_dpdk
*)(p
->priv
);
463 pd
->nonblock
= nonblock
;
467 static int pcap_dpdk_getnonblock(pcap_t
*p
){
468 struct pcap_dpdk
*pd
= (struct pcap_dpdk
*)(p
->priv
);
471 static int check_link_status(uint16_t portid
, struct rte_eth_link
*plink
)
473 // wait up to 9 seconds to get link status
474 rte_eth_link_get(portid
, plink
);
475 return plink
->link_status
== ETH_LINK_UP
;
477 static void eth_addr_str(struct ether_addr
*addrp
, char* mac_str
, int len
)
481 pcap_snprintf(mac_str
, len
-1, DPDK_DEF_MAC_ADDR
);
484 for (int i
=0; i
<6; i
++)
492 pcap_snprintf(mac_str
+offset
, len
-1-offset
, "%02X",addrp
->addr_bytes
[i
]);
495 pcap_snprintf(mac_str
+offset
, len
-1-offset
, ":%02X", addrp
->addr_bytes
[i
]);
501 // return portid by device name, otherwise return -1
502 static uint16_t portid_by_device(char * device
)
504 uint16_t ret
= DPDK_PORTID_MAX
;
505 int len
= strlen(device
);
506 int prefix_len
= strlen(DPDK_PREFIX
);
507 unsigned long ret_ul
= 0L;
509 if (len
<=prefix_len
|| strncmp(device
, DPDK_PREFIX
, prefix_len
)) // check prefix dpdk:
513 //check all chars are digital
514 for (int i
=prefix_len
; device
[i
]; i
++){
515 if (device
[i
]<'0' || device
[i
]>'9'){
519 ret_ul
= strtoul(&(device
[prefix_len
]), &pEnd
, 10);
520 if (pEnd
== &(device
[prefix_len
]) || *pEnd
!= '\0'){
523 // too large for portid
524 if (ret_ul
>= DPDK_PORTID_MAX
){
527 ret
= (uint16_t)ret_ul
;
531 static int parse_dpdk_cfg(char* dpdk_cfg
,char** dargv
)
534 memset(dargv
,0,sizeof(dargv
[0])*DPDK_ARGC_MAX
);
535 //current process name
538 RTE_LOG(INFO
, USER1
,"dpdk cfg: %s\n",dpdk_cfg
);
539 // find first non space char
540 // The last opt is NULL
541 for (i
=0;dpdk_cfg
[i
] && cnt
<DPDK_ARGC_MAX
-1;i
++){
542 if (skip_space
&& dpdk_cfg
[i
]!=' '){ // not space
543 skip_space
=!skip_space
; // skip normal char
544 dargv
[cnt
++] = dpdk_cfg
+i
;
546 if (!skip_space
&& dpdk_cfg
[i
]==' '){ // fint a space
547 dpdk_cfg
[i
]=0x00; // end of this opt
548 skip_space
=!skip_space
; // skip space char
560 // 0 if "the EAL cannot initialize on this system", which we treat as
561 // meaning "DPDK isn't available";
563 // a PCAP_ERROR_ code for other errors.
564 static int dpdk_pre_init(char * ebuf
)
567 char *dargv
[DPDK_ARGC_MAX
];
568 char *ptr_dpdk_cfg
= NULL
;
571 if (is_dpdk_pre_inited
!= 0)
573 // already inited; did that succeed?
574 if (is_dpdk_pre_inited
< 0)
585 // check for root permission
586 // XXX - is it sufficient to call rte_eal_init() and check for
590 RTE_LOG(ERR
, USER1
, "%s\n", DPDK_ERR_PERM_MSG
);
591 pcap_snprintf(ebuf
, PCAP_ERRBUF_SIZE
,
592 "DPDK requires that it run as root");
593 return PCAP_ERROR_PERM_DENIED
;
596 ptr_dpdk_cfg
= getenv(DPDK_CFG_ENV_NAME
);
597 // set default log level to debug
598 rte_log_set_global_level(DPDK_DEF_LOG_LEV
);
599 if (ptr_dpdk_cfg
== NULL
)
601 RTE_LOG(INFO
,USER1
,"env $DPDK_CFG is unset, so using default: %s\n",DPDK_DEF_CFG
);
602 ptr_dpdk_cfg
= DPDK_DEF_CFG
;
604 memset(dpdk_cfg_buf
,0,sizeof(dpdk_cfg_buf
));
605 snprintf(dpdk_cfg_buf
,DPDK_CFG_MAX_LEN
-1,"%s %s",DPDK_LIB_NAME
,ptr_dpdk_cfg
);
606 dargv_cnt
= parse_dpdk_cfg(dpdk_cfg_buf
,dargv
);
607 ret
= rte_eal_init(dargv_cnt
,dargv
);
610 // Indicate that we've called rte_eal_init() by setting
611 // is_dpdk_pre_inited to the negative of the error code,
612 // and process the error.
613 is_dpdk_pre_inited
= -rte_errno
;
616 // init succeeded, so we do not need to do it again later.
617 is_dpdk_pre_inited
= 1;
621 switch (-is_dpdk_pre_inited
)
624 // This "indicates a permissions issue.".
625 RTE_LOG(ERR
, USER1
, "%s\n", DPDK_ERR_PERM_MSG
);
626 pcap_snprintf(ebuf
, PCAP_ERRBUF_SIZE
,
627 "DPDK requires that it run as root");
628 return PCAP_ERROR_PERM_DENIED
;
631 // This "indicates either a bus or system
632 // resource was not available, setup may
633 // be attempted again."
634 // There's no such error in pcap, so I'm
635 // not sure what we should do here.
636 pcap_snprintf(ebuf
, PCAP_ERRBUF_SIZE
,
637 "Bus or system resource was not available");
641 // This "indicates that the rte_eal_init
642 // function has already been called, and
643 // cannot be called again."
644 // That's not an error; set the "we've
645 // been here before" flag and return
647 is_dpdk_pre_inited
= 1;
651 // This "indicates the tailq configuration
652 // name was not found in memory configuration."
653 pcap_snprintf(ebuf
, PCAP_ERRBUF_SIZE
,
654 "The tailq configuration name was not found in the memory configuration");
658 // This "indicates invalid parameters were
659 // passed as argv/argc." Those came from
660 // the configuration file.
661 pcap_snprintf(ebuf
, PCAP_ERRBUF_SIZE
,
662 "The configuration file has invalid parameters");
666 // This "indicates failure likely caused by
667 // an out-of-memory condition."
668 pcap_snprintf(ebuf
, PCAP_ERRBUF_SIZE
,
673 // This "indicates memory setup issues."
674 pcap_snprintf(ebuf
, PCAP_ERRBUF_SIZE
,
675 "An error occurred setting up memory");
679 // This "indicates that the EAL cannot
680 // initialize on this system." We treat
681 // that as meaning DPDK isn't available
682 // on this machine, rather than as a
683 // fatal error, and let our caller decide
684 // whether that's a fatal error (if trying
685 // to activate a DPDK device) or not (if
686 // trying to enumerate devices).
690 // This "indicates that the PCI bus is
691 // either not present, or is not readable
692 // by the eal." Does "the PCI bus is not
693 // present" mean "this machine has no PCI
694 // bus", which strikes me as a "not available"
695 // case? If so, should "is not readable by
696 // the EAL" also something we should treat
697 // as a "not available" case? If not, we
698 // can't distinguish between the two, so
700 pcap_snprintf(ebuf
, PCAP_ERRBUF_SIZE
,
701 "PCI bus is not present or not readable by the EAL");
705 // This "indicates that a service core
706 // failed to launch successfully."
707 pcap_snprintf(ebuf
, PCAP_ERRBUF_SIZE
,
708 "A service core failed to launch successfully");
713 // That's not in the list of errors in
714 // the documentation; let it be reported
717 dpdk_fmt_errmsg_for_rte_errno(ebuf
,
718 PCAP_ERRBUF_SIZE
, -is_dpdk_pre_inited
,
719 "dpdk error: dpdk_pre_init failed");
726 static int pcap_dpdk_activate(pcap_t
*p
)
728 struct pcap_dpdk
*pd
= p
->priv
;
730 int ret
= PCAP_ERROR
;
732 uint16_t portid
= DPDK_PORTID_MAX
;
733 unsigned nb_mbufs
= DPDK_NB_MBUFS
;
734 struct rte_eth_rxconf rxq_conf
;
735 struct rte_eth_txconf txq_conf
;
736 struct rte_eth_conf local_port_conf
= port_conf
;
737 struct rte_eth_dev_info dev_info
;
739 struct rte_eth_link link
;
742 char dpdk_pre_init_errbuf
[PCAP_ERRBUF_SIZE
];
743 ret
= dpdk_pre_init(dpdk_pre_init_errbuf
);
746 // This returns a negative value on an error.
747 pcap_snprintf(p
->errbuf
, PCAP_ERRBUF_SIZE
,
748 "Can't open device %s: %s",
749 p
->opt
.device
, dpdk_pre_init_errbuf
);
750 // ret is set to the correct error
755 // This means DPDK isn't available on this machine.
756 pcap_snprintf(p
->errbuf
, PCAP_ERRBUF_SIZE
,
757 "Can't open device %s: DPDK is not available on this machine",
759 return PCAP_ERROR_NO_SUCH_DEVICE
;
762 ret
= dpdk_init_timer(pd
);
765 pcap_snprintf(p
->errbuf
, PCAP_ERRBUF_SIZE
,
766 "dpdk error: Init timer is zero with device %s",
772 nb_ports
= rte_eth_dev_count_avail();
775 pcap_snprintf(p
->errbuf
, PCAP_ERRBUF_SIZE
,
776 "dpdk error: No Ethernet ports");
781 portid
= portid_by_device(p
->opt
.device
);
782 if (portid
== DPDK_PORTID_MAX
){
783 pcap_snprintf(p
->errbuf
, PCAP_ERRBUF_SIZE
,
784 "dpdk error: portid is invalid. device %s",
786 ret
= PCAP_ERROR_NO_SUCH_DEVICE
;
792 if (p
->snapshot
<= 0 || p
->snapshot
> MAXIMUM_SNAPLEN
)
794 p
->snapshot
= MAXIMUM_SNAPLEN
;
796 // create the mbuf pool
797 pd
->pktmbuf_pool
= rte_pktmbuf_pool_create(MBUF_POOL_NAME
, nb_mbufs
,
798 MEMPOOL_CACHE_SIZE
, 0, RTE_MBUF_DEFAULT_BUF_SIZE
,
800 if (pd
->pktmbuf_pool
== NULL
)
802 dpdk_fmt_errmsg_for_rte_errno(p
->errbuf
,
803 PCAP_ERRBUF_SIZE
, rte_errno
,
804 "dpdk error: Cannot init mbuf pool");
809 rte_eth_dev_info_get(portid
, &dev_info
);
810 if (dev_info
.tx_offload_capa
& DEV_TX_OFFLOAD_MBUF_FAST_FREE
)
812 local_port_conf
.txmode
.offloads
|=DEV_TX_OFFLOAD_MBUF_FAST_FREE
;
814 // only support 1 queue
815 ret
= rte_eth_dev_configure(portid
, 1, 1, &local_port_conf
);
818 dpdk_fmt_errmsg_for_rte_errno(p
->errbuf
,
819 PCAP_ERRBUF_SIZE
, -ret
,
820 "dpdk error: Cannot configure device: port=%u",
826 ret
= rte_eth_dev_adjust_nb_rx_tx_desc(portid
, &nb_rxd
, &nb_txd
);
829 dpdk_fmt_errmsg_for_rte_errno(p
->errbuf
,
830 PCAP_ERRBUF_SIZE
, -ret
,
831 "dpdk error: Cannot adjust number of descriptors: port=%u",
837 rte_eth_macaddr_get(portid
, &(pd
->eth_addr
));
838 eth_addr_str(&(pd
->eth_addr
), pd
->mac_addr
, DPDK_MAC_ADDR_SIZE
-1);
841 rxq_conf
= dev_info
.default_rxconf
;
842 rxq_conf
.offloads
= local_port_conf
.rxmode
.offloads
;
843 ret
= rte_eth_rx_queue_setup(portid
, 0, nb_rxd
,
844 rte_eth_dev_socket_id(portid
),
849 dpdk_fmt_errmsg_for_rte_errno(p
->errbuf
,
850 PCAP_ERRBUF_SIZE
, -ret
,
851 "dpdk error: rte_eth_rx_queue_setup:port=%u",
858 txq_conf
= dev_info
.default_txconf
;
859 txq_conf
.offloads
= local_port_conf
.txmode
.offloads
;
860 ret
= rte_eth_tx_queue_setup(portid
, 0, nb_txd
,
861 rte_eth_dev_socket_id(portid
),
865 dpdk_fmt_errmsg_for_rte_errno(p
->errbuf
,
866 PCAP_ERRBUF_SIZE
, -ret
,
867 "dpdk error: rte_eth_tx_queue_setup:port=%u",
872 // Initialize TX buffers
873 tx_buffer
= rte_zmalloc_socket(DPDK_TX_BUF_NAME
,
874 RTE_ETH_TX_BUFFER_SIZE(MAX_PKT_BURST
), 0,
875 rte_eth_dev_socket_id(portid
));
876 if (tx_buffer
== NULL
)
878 pcap_snprintf(p
->errbuf
, PCAP_ERRBUF_SIZE
,
879 "dpdk error: Cannot allocate buffer for tx on port %u", portid
);
883 rte_eth_tx_buffer_init(tx_buffer
, MAX_PKT_BURST
);
885 ret
= rte_eth_dev_start(portid
);
888 dpdk_fmt_errmsg_for_rte_errno(p
->errbuf
,
889 PCAP_ERRBUF_SIZE
, -ret
,
890 "dpdk error: rte_eth_dev_start:port=%u",
895 // set promiscuous mode
897 pd
->must_clear_promisc
=1;
898 rte_eth_promiscuous_enable(portid
);
901 is_port_up
= check_link_status(portid
, &link
);
903 pcap_snprintf(p
->errbuf
, PCAP_ERRBUF_SIZE
,
904 "dpdk error: link is down, port=%u",portid
);
905 ret
= PCAP_ERROR_IFACE_NOT_UP
;
909 rte_eth_stats_reset(pd
->portid
);
910 calculate_timestamp(&(pd
->ts_helper
), &(pd
->prev_ts
));
911 rte_eth_stats_get(pd
->portid
,&(pd
->prev_stats
));
915 if (p
->snapshot
<=0 || p
->snapshot
> MAXIMUM_SNAPLEN
)
917 p
->snapshot
= MAXIMUM_SNAPLEN
;
919 p
->linktype
= DLT_EN10MB
; // Ethernet, the 10MB is historical.
920 p
->selectable_fd
= p
->fd
;
921 p
->read_op
= pcap_dpdk_dispatch
;
922 p
->inject_op
= pcap_dpdk_inject
;
923 // using pcap_filter currently, though DPDK provides their own BPF function. Because DPDK BPF needs load a ELF file as a filter.
924 p
->setfilter_op
= install_bpf_program
;
925 p
->setdirection_op
= NULL
;
926 p
->set_datalink_op
= NULL
;
927 p
->getnonblock_op
= pcap_dpdk_getnonblock
;
928 p
->setnonblock_op
= pcap_dpdk_setnonblock
;
929 p
->stats_op
= pcap_dpdk_stats
;
930 p
->cleanup_op
= pcap_dpdk_close
;
931 p
->breakloop_op
= pcap_breakloop_common
;
932 // set default timeout
933 pd
->required_select_timeout
.tv_sec
= 0;
934 pd
->required_select_timeout
.tv_usec
= DPDK_DEF_MIN_SLEEP_MS
*1000;
935 p
->required_select_timeout
= &pd
->required_select_timeout
;
939 if (ret
<= PCAP_ERROR
) // all kinds of error code
941 pcap_cleanup_live_common(p
);
943 rte_eth_dev_get_name_by_port(portid
,pd
->pci_addr
);
944 RTE_LOG(INFO
, USER1
,"Port %d device: %s, MAC:%s, PCI:%s\n", portid
, p
->opt
.device
, pd
->mac_addr
, pd
->pci_addr
);
945 RTE_LOG(INFO
, USER1
,"Port %d Link Up. Speed %u Mbps - %s\n",
946 portid
, link
.link_speed
,
947 (link
.link_duplex
== ETH_LINK_FULL_DUPLEX
) ?
948 ("full-duplex") : ("half-duplex\n"));
953 // device name for dpdk shoud be in the form as dpdk:number, such as dpdk:0
954 pcap_t
* pcap_dpdk_create(const char *device
, char *ebuf
, int *is_ours
)
959 *is_ours
= !strncmp(device
, "dpdk:", 5);
963 p
= pcap_create_common(ebuf
, sizeof(struct pcap_dpdk
));
967 p
->activate_op
= pcap_dpdk_activate
;
971 int pcap_dpdk_findalldevs(pcap_if_list_t
*devlistp
, char *ebuf
)
974 unsigned int nb_ports
= 0;
975 char dpdk_name
[DPDK_DEV_NAME_MAX
];
976 char dpdk_desc
[DPDK_DEV_DESC_MAX
];
977 struct ether_addr eth_addr
;
978 char mac_addr
[DPDK_MAC_ADDR_SIZE
];
979 char pci_addr
[DPDK_PCI_ADDR_SIZE
];
981 char dpdk_pre_init_errbuf
[PCAP_ERRBUF_SIZE
];
982 ret
= dpdk_pre_init(dpdk_pre_init_errbuf
);
985 // This returns a negative value on an error.
986 pcap_snprintf(p
->errbuf
, PCAP_ERRBUF_SIZE
,
987 "Can't open device %s: %s",
988 p
->opt
.device
, dpdk_pre_init_errbuf
);
994 // This means DPDK isn't available on this machine.
995 // That just means "don't return any devices".
998 nb_ports
= rte_eth_dev_count_avail();
1001 // That just means "don't return any devices".
1005 for (unsigned int i
=0; i
<nb_ports
; i
++){
1006 pcap_snprintf(dpdk_name
, DPDK_DEV_NAME_MAX
-1,
1007 "%s%u", DPDK_PREFIX
, i
);
1009 rte_eth_macaddr_get(i
, ð_addr
);
1010 eth_addr_str(ð_addr
,mac_addr
,DPDK_MAC_ADDR_SIZE
);
1012 rte_eth_dev_get_name_by_port(i
,pci_addr
);
1013 pcap_snprintf(dpdk_desc
,DPDK_DEV_DESC_MAX
-1,"%s %s, MAC:%s, PCI:%s", DPDK_DESC
, dpdk_name
, mac_addr
, pci_addr
);
1014 if (add_dev(devlistp
, dpdk_name
, 0, dpdk_desc
, ebuf
)==NULL
){
1025 * This libpcap build supports only DPDK, not regular network interfaces.
1029 * There are no regular interfaces, just DPDK interfaces.
1032 pcap_platform_finddevs(pcap_if_list_t
*devlistp _U_
, char *errbuf
)
1038 * Attempts to open a regular interface fail.
1041 pcap_create_interface(const char *device
, char *errbuf
)
1043 pcap_snprintf(errbuf
, PCAP_ERRBUF_SIZE
,
1044 "This version of libpcap only supports DPDK");
1049 * Libpcap version string.
1052 pcap_lib_version(void)
1054 return (PCAP_VERSION_STRING
" (DPDK-only)");