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
, 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 matter 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;
319 u_char
*large_buffer
=NULL
;
320 int timeout_ms
= p
->opt
.timeout
;
322 if ( !PACKET_COUNT_IS_UNLIMITED(max_cnt
) && max_cnt
< MAX_PKT_BURST
){
325 burst_cnt
= MAX_PKT_BURST
;
328 while( PACKET_COUNT_IS_UNLIMITED(max_cnt
) || pkt_cnt
< max_cnt
){
331 return PCAP_ERROR_BREAK
;
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
);
338 RTE_LOG(DEBUG
, USER1
, "dpdk: no packets available in non-blocking mode.\n");
341 RTE_LOG(DEBUG
, USER1
, "dpdk: no packets available and break_loop is setted in blocking mode.\n");
343 return PCAP_ERROR_BREAK
;
346 RTE_LOG(DEBUG
, USER1
, "dpdk: no packets available for timeout %d ms in blocking mode.\n", timeout_ms
);
348 // break if dpdk reads 0 packet, no matter in blocking(timeout) or non-blocking mode.
352 for ( i
= 0; i
< nb_rx
; 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
;
362 rte_prefetch0(rte_pktmbuf_mtod(m
, void *));
366 bp
= rte_pktmbuf_mtod(m
, u_char
*);
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
)
371 gather_len
= dpdk_gather_data(pd
->pcap_tmp_buf
, RTE_ETH_PCAP_SNAPLEN
, m
);
372 bp
= pd
->pcap_tmp_buf
;
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
);
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
);
399 static int pcap_dpdk_inject(pcap_t
*p
, const void *buf _U_
, int size _U_
)
401 //not implemented yet
402 pcap_strlcpy(p
->errbuf
,
403 "dpdk error: Inject function has not been implemented yet",
408 static void pcap_dpdk_close(pcap_t
*p
)
410 struct pcap_dpdk
*pd
= p
->priv
;
415 if (pd
->must_clear_promisc
)
417 rte_eth_promiscuous_disable(pd
->portid
);
419 rte_eth_dev_stop(pd
->portid
);
420 rte_eth_dev_close(pd
->portid
);
421 pcap_cleanup_live_common(p
);
424 static void nic_stats_display(struct pcap_dpdk
*pd
)
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
);
435 static int pcap_dpdk_stats(pcap_t
*p
, struct pcap_stat
*ps
)
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
));
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
;
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
;
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
;
466 static int pcap_dpdk_getnonblock(pcap_t
*p
){
467 struct pcap_dpdk
*pd
= (struct pcap_dpdk
*)(p
->priv
);
470 static int check_link_status(uint16_t portid
, struct rte_eth_link
*plink
)
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
;
476 static void eth_addr_str(struct ether_addr
*addrp
, char* mac_str
, int len
)
480 pcap_snprintf(mac_str
, len
-1, DPDK_DEF_MAC_ADDR
);
483 for (int i
=0; i
<6; i
++)
491 pcap_snprintf(mac_str
+offset
, len
-1-offset
, "%02X",addrp
->addr_bytes
[i
]);
494 pcap_snprintf(mac_str
+offset
, len
-1-offset
, ":%02X", addrp
->addr_bytes
[i
]);
500 // return portid by device name, otherwise return -1
501 static uint16_t portid_by_device(char * device
)
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;
508 if (len
<=prefix_len
|| strncmp(device
, DPDK_PREFIX
, prefix_len
)) // check prefix dpdk:
512 //check all chars are digital
513 for (int i
=prefix_len
; device
[i
]; i
++){
514 if (device
[i
]<'0' || device
[i
]>'9'){
518 ret_ul
= strtoul(&(device
[prefix_len
]), &pEnd
, 10);
519 if (pEnd
== &(device
[prefix_len
]) || *pEnd
!= '\0'){
522 // too large for portid
523 if (ret_ul
>= DPDK_PORTID_MAX
){
526 ret
= (uint16_t)ret_ul
;
530 static int parse_dpdk_cfg(char* dpdk_cfg
,char** dargv
)
533 memset(dargv
,0,sizeof(dargv
[0])*DPDK_ARGC_MAX
);
534 //current process name
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
;
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
559 // 0 if "the EAL cannot initialize on this system", which we treat as
560 // meaning "DPDK isn't available";
562 // a PCAP_ERROR_ code for other errors.
563 static int dpdk_pre_init(char * ebuf
)
566 char *dargv
[DPDK_ARGC_MAX
];
567 char *ptr_dpdk_cfg
= NULL
;
570 if (is_dpdk_pre_inited
!= 0)
572 // already inited; did that succeed?
573 if (is_dpdk_pre_inited
< 0)
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
)
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
;
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
);
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
;
605 // init succeeded, so we do not need to do it again later.
606 is_dpdk_pre_inited
= 1;
610 switch (-is_dpdk_pre_inited
)
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
;
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");
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
636 is_dpdk_pre_inited
= 1;
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");
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");
655 // This "indicates failure likely caused by
656 // an out-of-memory condition."
657 pcap_snprintf(ebuf
, PCAP_ERRBUF_SIZE
,
662 // This "indicates memory setup issues."
663 pcap_snprintf(ebuf
, PCAP_ERRBUF_SIZE
,
664 "An error occurred setting up memory");
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).
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
689 pcap_snprintf(ebuf
, PCAP_ERRBUF_SIZE
,
690 "PCI bus is not present or not readable by the EAL");
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");
702 // That's not in the list of errors in
703 // the documentation; let it be reported
706 dpdk_fmt_errmsg_for_rte_errno(ebuf
,
707 PCAP_ERRBUF_SIZE
, -is_dpdk_pre_inited
,
708 "dpdk error: dpdk_pre_init failed");
715 static int pcap_dpdk_activate(pcap_t
*p
)
717 struct pcap_dpdk
*pd
= p
->priv
;
719 int ret
= PCAP_ERROR
;
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
;
728 struct rte_eth_link link
;
731 char dpdk_pre_init_errbuf
[PCAP_ERRBUF_SIZE
];
732 ret
= dpdk_pre_init(dpdk_pre_init_errbuf
);
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
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",
748 return PCAP_ERROR_NO_SUCH_DEVICE
;
751 ret
= dpdk_init_timer(pd
);
754 pcap_snprintf(p
->errbuf
, PCAP_ERRBUF_SIZE
,
755 "dpdk error: Init timer is zero with device %s",
761 nb_ports
= rte_eth_dev_count_avail();
764 pcap_snprintf(p
->errbuf
, PCAP_ERRBUF_SIZE
,
765 "dpdk error: No Ethernet ports");
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",
775 ret
= PCAP_ERROR_NO_SUCH_DEVICE
;
781 if (p
->snapshot
<= 0 || p
->snapshot
> MAXIMUM_SNAPLEN
)
783 p
->snapshot
= MAXIMUM_SNAPLEN
;
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
,
789 if (pd
->pktmbuf_pool
== NULL
)
791 dpdk_fmt_errmsg_for_rte_errno(p
->errbuf
,
792 PCAP_ERRBUF_SIZE
, rte_errno
,
793 "dpdk error: Cannot init mbuf pool");
798 rte_eth_dev_info_get(portid
, &dev_info
);
799 if (dev_info
.tx_offload_capa
& DEV_TX_OFFLOAD_MBUF_FAST_FREE
)
801 local_port_conf
.txmode
.offloads
|=DEV_TX_OFFLOAD_MBUF_FAST_FREE
;
803 // only support 1 queue
804 ret
= rte_eth_dev_configure(portid
, 1, 1, &local_port_conf
);
807 dpdk_fmt_errmsg_for_rte_errno(p
->errbuf
,
808 PCAP_ERRBUF_SIZE
, -ret
,
809 "dpdk error: Cannot configure device: port=%u",
815 ret
= rte_eth_dev_adjust_nb_rx_tx_desc(portid
, &nb_rxd
, &nb_txd
);
818 dpdk_fmt_errmsg_for_rte_errno(p
->errbuf
,
819 PCAP_ERRBUF_SIZE
, -ret
,
820 "dpdk error: Cannot adjust number of descriptors: port=%u",
826 rte_eth_macaddr_get(portid
, &(pd
->eth_addr
));
827 eth_addr_str(&(pd
->eth_addr
), pd
->mac_addr
, DPDK_MAC_ADDR_SIZE
-1);
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
),
838 dpdk_fmt_errmsg_for_rte_errno(p
->errbuf
,
839 PCAP_ERRBUF_SIZE
, -ret
,
840 "dpdk error: rte_eth_rx_queue_setup:port=%u",
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
),
854 dpdk_fmt_errmsg_for_rte_errno(p
->errbuf
,
855 PCAP_ERRBUF_SIZE
, -ret
,
856 "dpdk error: rte_eth_tx_queue_setup:port=%u",
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
)
867 pcap_snprintf(p
->errbuf
, PCAP_ERRBUF_SIZE
,
868 "dpdk error: Cannot allocate buffer for tx on port %u", portid
);
872 rte_eth_tx_buffer_init(tx_buffer
, MAX_PKT_BURST
);
874 ret
= rte_eth_dev_start(portid
);
877 dpdk_fmt_errmsg_for_rte_errno(p
->errbuf
,
878 PCAP_ERRBUF_SIZE
, -ret
,
879 "dpdk error: rte_eth_dev_start:port=%u",
884 // set promiscuous mode
886 pd
->must_clear_promisc
=1;
887 rte_eth_promiscuous_enable(portid
);
890 is_port_up
= check_link_status(portid
, &link
);
892 pcap_snprintf(p
->errbuf
, PCAP_ERRBUF_SIZE
,
893 "dpdk error: link is down, port=%u",portid
);
894 ret
= PCAP_ERROR_IFACE_NOT_UP
;
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
));
904 if (p
->snapshot
<=0 || p
->snapshot
> MAXIMUM_SNAPLEN
)
906 p
->snapshot
= MAXIMUM_SNAPLEN
;
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
;
928 if (ret
<= PCAP_ERROR
) // all kinds of error code
930 pcap_cleanup_live_common(p
);
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"));
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
)
948 *is_ours
= !strncmp(device
, "dpdk:", 5);
952 p
= pcap_create_common(ebuf
, sizeof(struct pcap_dpdk
));
956 p
->activate_op
= pcap_dpdk_activate
;
960 int pcap_dpdk_findalldevs(pcap_if_list_t
*devlistp
, char *ebuf
)
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
];
970 char dpdk_pre_init_errbuf
[PCAP_ERRBUF_SIZE
];
971 ret
= dpdk_pre_init(dpdk_pre_init_errbuf
);
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
);
983 // This means DPDK isn't available on this machine.
984 // That just means "don't return any devices".
987 nb_ports
= rte_eth_dev_count_avail();
990 // That just means "don't return any devices".
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
);
998 rte_eth_macaddr_get(i
, ð_addr
);
999 eth_addr_str(ð_addr
,mac_addr
,DPDK_MAC_ADDR_SIZE
);
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
){
1014 * This libpcap build supports only DPDK, not regular network interfaces.
1018 * There are no regular interfaces, just DPDK interfaces.
1021 pcap_platform_finddevs(pcap_if_list_t
*devlistp _U_
, char *errbuf
)
1027 * Attempts to open a regular interface fail.
1030 pcap_create_interface(const char *device
, char *errbuf
)
1032 pcap_snprintf(errbuf
, PCAP_ERRBUF_SIZE
,
1033 "This version of libpcap only supports DPDK");
1038 * Libpcap version string.
1041 pcap_lib_version(void)
1043 return (PCAP_VERSION_STRING
" (DPDK-only)");