]> The Tcpdump Group git mirrors - libpcap/blob - pcap-dpdk.c
We need rte_errno.h for rte_strerror() and rte_errno.
[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, uint16_t queueid,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 mater 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 int caplen = 0;
315 u_char *bp = NULL;
316 int i=0;
317 unsigned int gather_len =0;
318 int pkt_cnt = 0;
319 int is_accepted=0;
320 u_char *large_buffer=NULL;
321 int timeout_ms = p->opt.timeout;
322
323 if ( !PACKET_COUNT_IS_UNLIMITED(max_cnt) && max_cnt < MAX_PKT_BURST){
324 burst_cnt = max_cnt;
325 }else{
326 burst_cnt = MAX_PKT_BURST;
327 }
328
329 while( PACKET_COUNT_IS_UNLIMITED(max_cnt) || pkt_cnt < max_cnt){
330 if (p->break_loop){
331 p->break_loop = 0;
332 return PCAP_ERROR_BREAK;
333 }
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);
337 if (nb_rx == 0){
338 if (pd->nonblock){
339 RTE_LOG(DEBUG, USER1, "dpdk: no packets available in non-blocking mode.\n");
340 }else{
341 if (p->break_loop){
342 RTE_LOG(DEBUG, USER1, "dpdk: no packets available and break_loop is setted in blocking mode.\n");
343 p->break_loop = 0;
344 return PCAP_ERROR_BREAK;
345
346 }
347 RTE_LOG(DEBUG, USER1, "dpdk: no packets available for timeout %d ms in blocking mode.\n", timeout_ms);
348 }
349 // break if dpdk reads 0 packet, no matter in blocking(timeout) or non-blocking mode.
350 break;
351 }
352 pkt_cnt += nb_rx;
353 for ( i = 0; i < nb_rx; i++) {
354 m = pkts_burst[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;
362 // volatile prefetch
363 rte_prefetch0(rte_pktmbuf_mtod(m, void *));
364 bp = NULL;
365 if (m->nb_segs == 1)
366 {
367 bp = rte_pktmbuf_mtod(m, u_char *);
368 }else{
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)
371 {
372 gather_len = dpdk_gather_data(pd->pcap_tmp_buf, RTE_ETH_PCAP_SNAPLEN, m);
373 bp = pd->pcap_tmp_buf;
374 }else{
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);
378 bp = large_buffer;
379 }
380
381 }
382 if (bp){
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);
385 }else{
386 pd->bpf_drop++;
387 }
388 }
389 //free all pktmbuf
390 rte_pktmbuf_free(m);
391 if (large_buffer){
392 free(large_buffer);
393 large_buffer=NULL;
394 }
395 }
396 }
397 return pkt_cnt;
398 }
399
400 static int pcap_dpdk_inject(pcap_t *p, const void *buf _U_, int size _U_)
401 {
402 //not implemented yet
403 pcap_strlcpy(p->errbuf,
404 "dpdk error: Inject function has not been implemented yet",
405 PCAP_ERRBUF_SIZE);
406 return PCAP_ERROR;
407 }
408
409 static void pcap_dpdk_close(pcap_t *p)
410 {
411 struct pcap_dpdk *pd = p->priv;
412 if (pd==NULL)
413 {
414 return;
415 }
416 if (pd->must_clear_promisc)
417 {
418 rte_eth_promiscuous_disable(pd->portid);
419 }
420 rte_eth_dev_stop(pd->portid);
421 rte_eth_dev_close(pd->portid);
422 pcap_cleanup_live_common(p);
423 }
424
425 static void nic_stats_display(struct pcap_dpdk *pd)
426 {
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 );
434 }
435
436 static int pcap_dpdk_stats(pcap_t *p, struct pcap_stat *ps)
437 {
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));
441 if (ps){
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;
446 }
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;
458 return 0;
459 }
460
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;
464 return 0;
465 }
466
467 static int pcap_dpdk_getnonblock(pcap_t *p){
468 struct pcap_dpdk *pd = (struct pcap_dpdk*)(p->priv);
469 return pd->nonblock;
470 }
471 static int check_link_status(uint16_t portid, struct rte_eth_link *plink)
472 {
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;
476 }
477 static void eth_addr_str(struct ether_addr *addrp, char* mac_str, int len)
478 {
479 int offset=0;
480 if (addrp == NULL){
481 pcap_snprintf(mac_str, len-1, DPDK_DEF_MAC_ADDR);
482 return;
483 }
484 for (int i=0; i<6; i++)
485 {
486 if (offset >= len)
487 { // buffer overflow
488 return;
489 }
490 if (i==0)
491 {
492 pcap_snprintf(mac_str+offset, len-1-offset, "%02X",addrp->addr_bytes[i]);
493 offset+=2; // FF
494 }else{
495 pcap_snprintf(mac_str+offset, len-1-offset, ":%02X", addrp->addr_bytes[i]);
496 offset+=3; // :FF
497 }
498 }
499 return;
500 }
501 // return portid by device name, otherwise return -1
502 static uint16_t portid_by_device(char * device)
503 {
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;
508 char *pEnd;
509 if (len<=prefix_len || strncmp(device, DPDK_PREFIX, prefix_len)) // check prefix dpdk:
510 {
511 return ret;
512 }
513 //check all chars are digital
514 for (int i=prefix_len; device[i]; i++){
515 if (device[i]<'0' || device[i]>'9'){
516 return ret;
517 }
518 }
519 ret_ul = strtoul(&(device[prefix_len]), &pEnd, 10);
520 if (pEnd == &(device[prefix_len]) || *pEnd != '\0'){
521 return ret;
522 }
523 // too large for portid
524 if (ret_ul >= DPDK_PORTID_MAX){
525 return ret;
526 }
527 ret = (uint16_t)ret_ul;
528 return ret;
529 }
530
531 static int parse_dpdk_cfg(char* dpdk_cfg,char** dargv)
532 {
533 int cnt=0;
534 memset(dargv,0,sizeof(dargv[0])*DPDK_ARGC_MAX);
535 //current process name
536 int skip_space = 1;
537 int i=0;
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;
545 }
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
549 }
550 }
551 dargv[cnt]=NULL;
552 return cnt;
553 }
554
555 // only called once
556 // Returns:
557 //
558 // 1 on success;
559 //
560 // 0 if "the EAL cannot initialize on this system", which we treat as
561 // meaning "DPDK isn't available";
562 //
563 // a PCAP_ERROR_ code for other errors.
564 static int dpdk_pre_init(char * ebuf)
565 {
566 int dargv_cnt=0;
567 char *dargv[DPDK_ARGC_MAX];
568 char *ptr_dpdk_cfg = NULL;
569 int ret;
570 // globale var
571 if (is_dpdk_pre_inited != 0)
572 {
573 // already inited; did that succeed?
574 if (is_dpdk_pre_inited < 0)
575 {
576 // failed
577 goto error;
578 }
579 else
580 {
581 // succeeded
582 return 1;
583 }
584 }
585 // check for root permission
586 // XXX - is it sufficient to call rte_eal_init() and check for
587 // EACCES?
588 if( geteuid() != 0)
589 {
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;
594 }
595 // init EAL
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)
600 {
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;
603 }
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);
608 if (ret == -1)
609 {
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;
614 goto error;
615 }
616 // init succeeded, so we do not need to do it again later.
617 is_dpdk_pre_inited = 1;
618 return 1;
619
620 error:
621 switch (-is_dpdk_pre_inited)
622 {
623 case EACCES:
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;
629
630 case EAGAIN:
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");
638 break;
639
640 case EALREADY:
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
646 // success.
647 is_dpdk_pre_inited = 1;
648 return 1;
649
650 case EFAULT:
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");
655 return PCAP_ERROR;
656
657 case EINVAL:
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");
663 break;
664
665 case ENOMEM:
666 // This "indicates failure likely caused by
667 // an out-of-memory condition."
668 pcap_snprintf(ebuf, PCAP_ERRBUF_SIZE,
669 "Out of memory");
670 break;
671
672 case ENODEV:
673 // This "indicates memory setup issues."
674 pcap_snprintf(ebuf, PCAP_ERRBUF_SIZE,
675 "An error occurred setting up memory");
676 break;
677
678 case ENOTSUP:
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).
687 return 0;
688
689 case EPROTO:
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
699 // we're stuck.
700 pcap_snprintf(ebuf, PCAP_ERRBUF_SIZE,
701 "PCI bus is not present or not readable by the EAL");
702 break;
703
704 case ENOEXEC:
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");
709 break;
710
711 default:
712 //
713 // That's not in the list of errors in
714 // the documentation; let it be reported
715 // as an error.
716 //
717 dpdk_fmt_errmsg_for_rte_errno(ebuf,
718 PCAP_ERRBUF_SIZE, -is_dpdk_pre_inited,
719 "dpdk error: dpdk_pre_init failed");
720 break;
721 }
722 // Error.
723 return PCAP_ERROR;
724 }
725
726 static int pcap_dpdk_activate(pcap_t *p)
727 {
728 struct pcap_dpdk *pd = p->priv;
729 pd->orig = p;
730 int ret = PCAP_ERROR;
731 uint16_t nb_ports=0;
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;
738 int is_port_up = 0;
739 struct rte_eth_link link;
740 do{
741 //init EAL
742 char dpdk_pre_init_errbuf[PCAP_ERRBUF_SIZE];
743 ret = dpdk_pre_init(dpdk_pre_init_errbuf);
744 if (ret < 0)
745 {
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
751 break;
752 }
753 if (ret == 0)
754 {
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",
758 p->opt.device);
759 return PCAP_ERROR_NO_SUCH_DEVICE;
760 }
761
762 ret = dpdk_init_timer(pd);
763 if (ret<0)
764 {
765 pcap_snprintf(p->errbuf, PCAP_ERRBUF_SIZE,
766 "dpdk error: Init timer is zero with device %s",
767 p->opt.device);
768 ret = PCAP_ERROR;
769 break;
770 }
771
772 nb_ports = rte_eth_dev_count_avail();
773 if (nb_ports == 0)
774 {
775 pcap_snprintf(p->errbuf, PCAP_ERRBUF_SIZE,
776 "dpdk error: No Ethernet ports");
777 ret = PCAP_ERROR;
778 break;
779 }
780
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",
785 p->opt.device);
786 ret = PCAP_ERROR_NO_SUCH_DEVICE;
787 break;
788 }
789
790 pd->portid = portid;
791
792 if (p->snapshot <= 0 || p->snapshot > MAXIMUM_SNAPLEN)
793 {
794 p->snapshot = MAXIMUM_SNAPLEN;
795 }
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,
799 rte_socket_id());
800 if (pd->pktmbuf_pool == NULL)
801 {
802 dpdk_fmt_errmsg_for_rte_errno(p->errbuf,
803 PCAP_ERRBUF_SIZE, rte_errno,
804 "dpdk error: Cannot init mbuf pool");
805 ret = PCAP_ERROR;
806 break;
807 }
808 // config dev
809 rte_eth_dev_info_get(portid, &dev_info);
810 if (dev_info.tx_offload_capa & DEV_TX_OFFLOAD_MBUF_FAST_FREE)
811 {
812 local_port_conf.txmode.offloads |=DEV_TX_OFFLOAD_MBUF_FAST_FREE;
813 }
814 // only support 1 queue
815 ret = rte_eth_dev_configure(portid, 1, 1, &local_port_conf);
816 if (ret < 0)
817 {
818 dpdk_fmt_errmsg_for_rte_errno(p->errbuf,
819 PCAP_ERRBUF_SIZE, -ret,
820 "dpdk error: Cannot configure device: port=%u",
821 portid);
822 ret = PCAP_ERROR;
823 break;
824 }
825 // adjust rx tx
826 ret = rte_eth_dev_adjust_nb_rx_tx_desc(portid, &nb_rxd, &nb_txd);
827 if (ret < 0)
828 {
829 dpdk_fmt_errmsg_for_rte_errno(p->errbuf,
830 PCAP_ERRBUF_SIZE, -ret,
831 "dpdk error: Cannot adjust number of descriptors: port=%u",
832 portid);
833 ret = PCAP_ERROR;
834 break;
835 }
836 // get MAC addr
837 rte_eth_macaddr_get(portid, &(pd->eth_addr));
838 eth_addr_str(&(pd->eth_addr), pd->mac_addr, DPDK_MAC_ADDR_SIZE-1);
839
840 // init one RX queue
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),
845 &rxq_conf,
846 pd->pktmbuf_pool);
847 if (ret < 0)
848 {
849 dpdk_fmt_errmsg_for_rte_errno(p->errbuf,
850 PCAP_ERRBUF_SIZE, -ret,
851 "dpdk error: rte_eth_rx_queue_setup:port=%u",
852 portid);
853 ret = PCAP_ERROR;
854 break;
855 }
856
857 // init one TX queue
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),
862 &txq_conf);
863 if (ret < 0)
864 {
865 dpdk_fmt_errmsg_for_rte_errno(p->errbuf,
866 PCAP_ERRBUF_SIZE, -ret,
867 "dpdk error: rte_eth_tx_queue_setup:port=%u",
868 portid);
869 ret = PCAP_ERROR;
870 break;
871 }
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)
877 {
878 pcap_snprintf(p->errbuf, PCAP_ERRBUF_SIZE,
879 "dpdk error: Cannot allocate buffer for tx on port %u", portid);
880 ret = PCAP_ERROR;
881 break;
882 }
883 rte_eth_tx_buffer_init(tx_buffer, MAX_PKT_BURST);
884 // Start device
885 ret = rte_eth_dev_start(portid);
886 if (ret < 0)
887 {
888 dpdk_fmt_errmsg_for_rte_errno(p->errbuf,
889 PCAP_ERRBUF_SIZE, -ret,
890 "dpdk error: rte_eth_dev_start:port=%u",
891 portid);
892 ret = PCAP_ERROR;
893 break;
894 }
895 // set promiscuous mode
896 if (p->opt.promisc){
897 pd->must_clear_promisc=1;
898 rte_eth_promiscuous_enable(portid);
899 }
900 // check link status
901 is_port_up = check_link_status(portid, &link);
902 if (!is_port_up){
903 pcap_snprintf(p->errbuf, PCAP_ERRBUF_SIZE,
904 "dpdk error: link is down, port=%u",portid);
905 ret = PCAP_ERROR_IFACE_NOT_UP;
906 break;
907 }
908 // reset statistics
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));
912 // format pcap_t
913 pd->portid = portid;
914 p->fd = pd->portid;
915 if (p->snapshot <=0 || p->snapshot> MAXIMUM_SNAPLEN)
916 {
917 p->snapshot = MAXIMUM_SNAPLEN;
918 }
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;
936 ret = 0; // OK
937 }while(0);
938
939 if (ret <= PCAP_ERROR) // all kinds of error code
940 {
941 pcap_cleanup_live_common(p);
942 }else{
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"));
949 }
950 return ret;
951 }
952
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)
955 {
956 pcap_t *p=NULL;
957 *is_ours = 0;
958
959 *is_ours = !strncmp(device, "dpdk:", 5);
960 if (! *is_ours)
961 return NULL;
962 //memset will happen
963 p = pcap_create_common(ebuf, sizeof(struct pcap_dpdk));
964
965 if (p == NULL)
966 return NULL;
967 p->activate_op = pcap_dpdk_activate;
968 return p;
969 }
970
971 int pcap_dpdk_findalldevs(pcap_if_list_t *devlistp, char *ebuf)
972 {
973 int ret=0;
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];
980 do{
981 char dpdk_pre_init_errbuf[PCAP_ERRBUF_SIZE];
982 ret = dpdk_pre_init(dpdk_pre_init_errbuf);
983 if (ret < 0)
984 {
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);
989 ret = PCAP_ERRNO;
990 break;
991 }
992 if (ret == 0)
993 {
994 // This means DPDK isn't available on this machine.
995 // That just means "don't return any devices".
996 break;
997 }
998 nb_ports = rte_eth_dev_count_avail();
999 if (nb_ports == 0)
1000 {
1001 // That just means "don't return any devices".
1002 ret = 0;
1003 break;
1004 }
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);
1008 // mac addr
1009 rte_eth_macaddr_get(i, &eth_addr);
1010 eth_addr_str(&eth_addr,mac_addr,DPDK_MAC_ADDR_SIZE);
1011 // PCI addr
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){
1015 ret = PCAP_ERROR;
1016 break;
1017 }
1018 }
1019 }while(0);
1020 return ret;
1021 }
1022
1023 #ifdef DPDK_ONLY
1024 /*
1025 * This libpcap build supports only DPDK, not regular network interfaces.
1026 */
1027
1028 /*
1029 * There are no regular interfaces, just DPDK interfaces.
1030 */
1031 int
1032 pcap_platform_finddevs(pcap_if_list_t *devlistp _U_, char *errbuf)
1033 {
1034 return (0);
1035 }
1036
1037 /*
1038 * Attempts to open a regular interface fail.
1039 */
1040 pcap_t *
1041 pcap_create_interface(const char *device, char *errbuf)
1042 {
1043 pcap_snprintf(errbuf, PCAP_ERRBUF_SIZE,
1044 "This version of libpcap only supports DPDK");
1045 return NULL;
1046 }
1047
1048 /*
1049 * Libpcap version string.
1050 */
1051 const char *
1052 pcap_lib_version(void)
1053 {
1054 return (PCAP_VERSION_STRING " (DPDK-only)");
1055 }
1056 #endif