asavie / xdp

Package xdp allows one to use XDP sockets from the Go programming language.
BSD 3-Clause "New" or "Revised" License
298 stars 64 forks source link
dataplane go golang golang-package linux network network-programming networking packet-capture packet-generator packet-processing packet-sniffer packets sdn sdn-network sdn-switch software-defined-network software-defined-networking xdp xdp-sockets

The project is continued here: https://github.com/slavc/xdp

https://github.com/asavie/xdp is now archived.


xdp

Go Reference

Package github.com/asavie/xdp allows one to use XDP sockets from the Go programming language.

For usage examples, see the documentation or the examples/ directory.

Performance

examples/sendudp

With the default UDP payload size of 1400 bytes, running on Linux kernel 5.1.20, on a tg3 (so no native XDP support) gigabit NIC, sendudp.go does around 980 Mb/s, so practically line rate.

examples/senddnsqueries

TL;DR: in the same environment, sending a pre-generated DNS query using an ordinary UDP socket yields around 30 MiB/s whereas sending it using the senddnsqueries.go example program yields around 77 MiB/s.

Connecting a PC with Intel Core i7-7700 CPU running Linux kernel 5.0.17 and igb driver to a laptop with Intel Core i7-5600U CPU running Linux kernel 5.0.9 with e1000e with a cat 5E gigabit ethernet cable and using the following program

package main

import (
    "net"

    "github.com/miekg/dns"
)

func main() {
    query := new(dns.Msg)
    query.SetQuestion(dns.Fqdn("asavie.com"), dns.TypeA)
    payload, err := query.Pack()
    if err != nil {
        panic(err)
    }

    conn, err := net.ListenPacket("udp", ":0")
    if err != nil {
        panic(err)
    }
    defer conn.Close()

    dst, err := net.ResolveUDPAddr("udp", "192.168.111.10:53")
    if err != nil {
        panic(err)
    }

    for {
        _, err = conn.WriteTo(payload, dst)
        if err != nil {
            panic(err)
        }
    }
}

which uses an ordinary UDP socket to send a pre-generated DNS query from PC to laptop as quickly as possible - I get about 30 MiB/s at laptop side.

Using the senddnsqueries.go example program - I get about 77 MiB/s at laptop side.