mdlayher/netlink mdlayher/netlink

  • Stars
    star
    876
  • Rank 52,107 (Top 2 %)
  • Language
    Go
  • License
    MIT License
  • Created almost 8 years ago
  • Updated 8 months ago
Twitter logo Share LinkedIn logo Share Facebook logo Share
mdlayher/netlink
github

mdlayher

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Package netlink provides low-level access to Linux netlink sockets (AF_NETLINK). MIT Licensed.

netlink Test Status Go Reference Go Report Card

Package netlink provides low-level access to Linux netlink sockets (AF_NETLINK). MIT Licensed.

For more information about how netlink works, check out my blog series on Linux, Netlink, and Go.

If you have any questions or you'd like some guidance, please join us on Gophers Slack in the #networking channel!

Stability

See the CHANGELOG file for a description of changes between releases.

This package has a stable v1 API and any future breaking changes will prompt the release of a new major version. Features and bug fixes will continue to occur in the v1.x.x series.

This package only supports the two most recent major versions of Go, mirroring Go's own release policy. Older versions of Go may lack critical features and bug fixes which are necessary for this package to function correctly.

Design

A number of netlink packages are already available for Go, but I wasn't able to find one that aligned with what I wanted in a netlink package:

  • Straightforward, idiomatic API
  • Well tested
  • Well documented
  • Doesn't use package/global variables or state
  • Doesn't necessarily need root to work

My goal for this package is to use it as a building block for the creation of other netlink family packages.

Ecosystem

Over time, an ecosystem of Go packages has developed around package netlink. Many of these packages provide building blocks for further interactions with various netlink families, such as NETLINK_GENERIC or NETLINK_ROUTE.

To have your package included in this diagram, please send a pull request!

flowchart LR
    netlink["github.com/mdlayher/netlink"]
    click netlink "https://github.com/mdlayher/netlink"

    subgraph "NETLINK_CONNECTOR"
        direction LR

        garlic["github.com/fearful-symmetry/garlic"]
        click garlic "https://github.com/fearful-symmetry/garlic"
    end

    subgraph "NETLINK_CRYPTO"
        direction LR

        cryptonl["github.com/mdlayher/cryptonl"]
        click cryptonl "https://github.com/mdlayher/cryptonl"
    end

    subgraph "NETLINK_GENERIC"
        direction LR

        genetlink["github.com/mdlayher/genetlink"]
        click genetlink "https://github.com/mdlayher/genetlink"

        devlink["github.com/mdlayher/devlink"]
        click devlink "https://github.com/mdlayher/devlink"

        ethtool["github.com/mdlayher/ethtool"]
        click ethtool "https://github.com/mdlayher/ethtool"

        go-openvswitch["github.com/digitalocean/go-openvswitch"]
        click go-openvswitch "https://github.com/digitalocean/go-openvswitch"

        ipvs["github.com/cloudflare/ipvs"]
        click ipvs "https://github.com/cloudflare/ipvs"

        l2tp["github.com/axatrax/l2tp"]
        click l2tp "https://github.com/axatrax/l2tp"

        nbd["github.com/Merovius/nbd"]
        click nbd "https://github.com/Merovius/nbd"

        quota["github.com/mdlayher/quota"]
        click quota "https://github.com/mdlayher/quota"

        router7["github.com/rtr7/router7"]
        click router7 "https://github.com/rtr7/router7"

        taskstats["github.com/mdlayher/taskstats"]
        click taskstats "https://github.com/mdlayher/taskstats"

        u-bmc["github.com/u-root/u-bmc"]
        click u-bmc "https://github.com/u-root/u-bmc"

        wgctrl["golang.zx2c4.com/wireguard/wgctrl"]
        click wgctrl "https://golang.zx2c4.com/wireguard/wgctrl"

        wifi["github.com/mdlayher/wifi"]
        click wifi "https://github.com/mdlayher/wifi"

        devlink & ethtool & go-openvswitch & ipvs --> genetlink
        l2tp & nbd & quota & router7 & taskstats --> genetlink
        u-bmc & wgctrl & wifi --> genetlink
    end

    subgraph "NETLINK_KOBJECT_UEVENT"
        direction LR

        kobject["github.com/mdlayher/kobject"]
        click kobject "https://github.com/mdlayher/kobject"
    end

    subgraph "NETLINK_NETFILTER"
        direction LR

        go-conntrack["github.com/florianl/go-conntrack"]
        click go-conntrack "https://github.com/florianl/go-conntrack"

        go-nflog["github.com/florianl/go-nflog"]
        click go-nflog "https://github.com/florianl/go-nflog"

        go-nfqueue["github.com/florianl/go-nfqueue"]
        click go-nfqueue "https://github.com/florianl/go-nfqueue"

        netfilter["github.com/ti-mo/netfilter"]
        click netfilter "https://github.com/ti-mo/netfilter"

        nftables["github.com/google/nftables"]
        click nftables "https://github.com/google/nftables"

        conntrack["github.com/ti-mo/conntrack"]
        click conntrack "https://github.com/ti-mo/conntrack"

        conntrack --> netfilter
    end

    subgraph "NETLINK_ROUTE"
        direction LR

        go-tc["github.com/florianl/go-tc"]
        click go-tc "https://github.com/florianl/go-tc"

        qdisc["github.com/ema/qdisc"]
        click qdisc "https://github.com/ema/qdisc"

        rtnetlink["github.com/jsimonetti/rtnetlink"]
        click rtnetlink "https://github.com/jsimonetti/rtnetlink"

        rtnl["gitlab.com/mergetb/tech/rtnl"]
        click rtnl "https://gitlab.com/mergetb/tech/rtnl"
    end

    subgraph "NETLINK_W1"
        direction LR

        go-onewire["github.com/SpComb/go-onewire"]
        click go-onewire "https://github.com/SpComb/go-onewire"
    end

    NETLINK_CONNECTOR --> netlink
    NETLINK_CRYPTO --> netlink
    NETLINK_GENERIC --> netlink
    NETLINK_KOBJECT_UEVENT --> netlink
    NETLINK_NETFILTER --> netlink
    NETLINK_ROUTE --> netlink
    NETLINK_W1 --> netlink

More Repositories

1

raw

Package raw enables reading and writing data at the device driver level for a network interface. MIT Licensed.
Go
423
star
2

waveform

Go package capable of generating waveform images from audio streams. MIT Licensed.
Go
355
star
3

arp

Package arp implements the ARP protocol, as described in RFC 826. MIT Licensed.
Go
350
star
4

vsock

Package vsock provides access to Linux VM sockets (AF_VSOCK) for communication between a hypervisor and its virtual machines. MIT Licensed.
Go
331
star
5

ethernet

Package ethernet implements marshaling and unmarshaling of IEEE 802.3 Ethernet II frames and IEEE 802.1Q VLAN tags. MIT Licensed.
Go
271
star
6

wifi

Package wifi provides access to IEEE 802.11 WiFi device actions and statistics. MIT Licensed.
Go
258
star
7

unifi_exporter

Prometheus exporter that exposes metrics from a Ubiquiti UniFi Controller and UniFi devices. MIT Licensed.
Go
255
star
8

ndp

Package ndp implements the Neighbor Discovery Protocol, as described in RFC 4861. MIT Licensed.
Go
217
star
9

corerad

CoreRAD is an extensible and observable IPv6 Neighbor Discovery Protocol router advertisement daemon. Apache 2.0 Licensed.
Go
147
star
10

apcupsd_exporter

Prometheus exporter that exposes metrics from apcupsd's NIS. MIT Licensed.
Go
142
star
11

schedgroup

Package schedgroup provides a goroutine worker pool which schedules tasks to be performed at or after a specified time. MIT Licensed.
Go
131
star
12

consrv

Command consrv is a SSH to serial console bridge server, originally designed for deployment on gokrazy.org devices. Apache 2.0 Licensed.
Go
129
star
13

wireguard_exporter

Command wireguard_exporter implements a Prometheus exporter for WireGuard devices. MIT Licensed.
Go
116
star
14

wavepipe

Cross-platform media server, written in Go. MIT Licensed.
Go
110
star
15

goat

Goat: Go Awesome Tracker. BitTorrent tracker implementation, written in Go. MIT Licensed.
Go
92
star
16

wol

Package wol implements a Wake-on-LAN client. MIT Licensed.
Go
90
star
17

packet

Package packet provides access to Linux packet sockets (AF_PACKET). MIT Licensed.
Go
85
star
18

homelab

Configuration management for Matt Layher's machines. MIT Licensed.
Nix
82
star
19

dhcp6

Package dhcp6 implements a DHCPv6 server, as described in RFC 3315. MIT Licensed.
Go
77
star
20

socket

Package socket provides a low-level network connection type which integrates with Go's runtime network poller to provide asynchronous I/O and deadline support. MIT Licensed.
Go
74
star
21

talks

Talks by Matt Layher. MIT Licensed.
Go
63
star
22

unifi

Package unifi implements a client for the Ubiquiti UniFi Controller v4 and v5 API. MIT Licensed.
Go
59
star
23

ethtool

Package ethtool allows control of the Linux ethtool generic netlink interface. MIT Licensed.
Go
59
star
24

taskstats

Package taskstats provides access to Linux's taskstats interface, for sending per-task and per-process statistics from the kernel to userspace. MIT Licensed.
Go
59
star
25

genetlink

Package genetlink implements generic netlink interactions and data types. MIT Licensed.
Go
53
star
26

apcupsd

Package apcupsd provides a client for the apcupsd Network Information Server (NIS). MIT Licensed.
Go
42
star
27

sdnotify

Package sdnotify implements systemd readiness notifications as described in https://www.freedesktop.org/software/systemd/man/sd_notify.html. MIT Licensed.
Go
40
star
28

rtorrent_exporter

Prometheus exporter that exposes metrics from rTorrent. MIT Licensed.
Go
39
star
29

xdp

Package xdp provides access to Linux userspace XDP sockets (AF_XDP). MIT Licensed.
Go
38
star
30

keylight

Package keylight allows control of Elgato Key Light devices. MIT Licensed.
Go
30
star
31

lldp

Package lldp implements marshaling and unmarshaling of IEEE 802.1AB Link Layer Discovery Protocol frames. MIT Licensed.
Go
30
star
32

icmpx

Package icmpx provides low-level ICMPv4 (IPPROTO_ICMP) and ICMPv6 (IPPROTO_ICMPV6) raw socket support for Linux. MIT Licensed.
Go
29
star
33

prombolt

Package prombolt provides a Prometheus metrics collector for Bolt databases. MIT Licensed.
Go
29
star
34

wgipam

Command wgipamd implements an IP Address Management (IPAM) daemon for dynamic IP address assignment to WireGuard peers, using the wg-dynamic protocol. Apache 2.0 Licensed.
Go
28
star
35

untappd

Package untappd provides an Untappd APIv4 client, written in Go. MIT Licensed.
Go
25
star
36

watchdog

Package watchdog implements control of hardware watchdog devices. MIT Licensed.
Go
25
star
37

netx

A collection of small Go networking packages. MIT Licensed.
Go
24
star
38

lmsensors

Package lmsensors provides access to Linux monitoring sensors data, such as temperatures, voltage, and fan speeds. MIT Licensed.
Go
22
star
39

obd

OBD-II class for vehicle self-diagnostics, written in PHP
PHP
20
star
40

block

Package block enables programmatic access to block devices. MIT Licensed.
Go
20
star
41

kobject

Package kobject provides access to Linux kobject userspace events. MIT Licensed.
Go
20
star
42

php-bloomd

PHP 5.4+ class for interacting with a bloomd server. MIT Licensed.
PHP
20
star
43

scanrs

A port scanner written in Rust, as an exercise to learn more about Rust! MIT Licensed.
Rust
19
star
44

taggolib

taggolib is a Go package which provides read-only access to metadata contained in various audio formats. MIT Licensed.
Go
17
star
45

networkd

Package networkd enables control of systemd-networkd using D-Bus. MIT Licensed.
Go
16
star
46

mptcp

Package mptcp provides detection functionality for active, multipath TCP connections from a remote client to the current host. MIT Licensed.
Go
16
star
47

monkey-rs

A Rust implementation of the Monkey programming language from https://interpreterbook.com/. MIT Licensed.
Rust
16
star
48

ospf3

Package ospf3 implements OSPFv3 (OSPF for IPv6) as described in RFC5340. MIT Licensed.
Go
15
star
49

hdhomerun_exporter

Command hdhomerun_exporter implements a Prometheus exporter for SiliconDust HDHomeRun devices. MIT Licensed.
Go
15
star
50

edgemax

Package edgemax implements a client for Ubiquiti EdgeMAX devices. MIT Licensed.
Go
14
star
51

alg

Package alg provides access to Linux AF_ALG sockets for communication with the Linux kernel crypto API. MIT Licensed.
Go
14
star
52

zedhook

zedhook provides a ZEDLET (ZFS Event Daemon Linkage for Executable Tasks) and zevent receiver server to monitor and log ZFS events produced by ZED. Apache 2.0 Licensed.
Go
14
star
53

wgdynamic-go

Package wgdynamic implements a client and server for the the wg-dynamic protocol. MIT Licensed.
Go
13
star
54

netstate

Package netstate provides notification of network interface state changes. MIT Licensed.
Go
13
star
55

rfc4193

Package rfc4193 implements Unique Local IPv6 Unicast Address prefix generation, as described in RFC 4193. MIT Licensed.
13
star
56

subfs

Experimental FUSE filesystem for the Subsonic media server, written in Go. MIT Licensed.
Go
13
star
57

wifiqr

Package wifiqr implements support for generating WiFi QR codes. MIT Licensed.
Go
12
star
58

php-serial

PHP class utilizing Direct IO to interact with a RS232 serial port
PHP
12
star
59

aoe

Package aoe implements an ATA over Ethernet server, as described in the AoEr11 specification. MIT Licensed.
Go
12
star
60

smbios-rs

Provides detection and access to System Management BIOS (SMBIOS) and Desktop Management Interface (DMI) data and structures. MIT Licensed.
Rust
12
star
61

edgemax_exporter

Prometheus exporter that exposes metrics from Ubiquiti EdgeMAX devices. MIT Licensed.
Go
12
star
62

vxlan

Package vxlan implements marshaling and unmarshaling of Virtual eXtensible Local Area Network (VXLAN) frames, as described in RFC 7348. MIT Licensed.
Go
11
star
63

tftp

Package tftp implements a TFTP server, as described in RFC 1350. MIT Licensed.
Go
10
star
64

nbd-rs

An asynchronous Rust client and server implementation of the Network Block Device (NBD) protocol. MIT Licensed.
Rust
10
star
65

devlink

Package devlink provides access to Linux's devlink interface. MIT Licensed.
Go
9
star
66

hdhomerun

Package hdhomerun enables interacting with SiliconDust HDHomeRun devices. MIT Licensed.
Go
9
star
67

ordered

Package ordered implements data structures which maintain consistent ordering of inserted elements.
Go
9
star
68

cryptonl

Package cryptonl provides access to the Linux kernel crypto API's netlink interface. MIT Licensed.
Go
9
star
69

metricslite

Package metricslite implements a lightweight, testable metrics interface focused on Prometheus metrics. MIT Licensed.
Go
9
star
70

rtorrent

Package rtorrent implements a client for rTorrent. MIT Licensed.
Go
8
star
71

atmodem

Package atmodem provides a high-level interface for controlling modems using the AT command set. MIT Licensed.
Go
8
star
72

modemmanager

Package modemmanager enables Go programs to control ModemManager and its devices using D-Bus. MIT Licensed.
Go
8
star
73

yamlnetlink

Package yamlnetlink provides support for parsing YAML netlink specifications. MIT Licensed.
Go
7
star
74

eui64

Package eui64 enables creation and parsing of Modified EUI-64 format interface identifiers, as described in RFC 4291, Section 2.5.1. MIT Licensed.
7
star
75

arris_exporter

Command arris_exporter implements a Prometheus exporter for Arris cable modem devices. MIT Licensed.
Go
6
star
76

lmsensors_exporter

Prometheus exporter that exposes lm_sensors sensor metrics. MIT Licensed.
Go
6
star
77

quota

Package quota provides access to Linux quota netlink notifications. MIT Licensed.
Go
6
star
78

mpdsub

Command mpdsubd provides a Subsonic HTTP API bridge to a backing MPD server. MIT Licensed.
Go
6
star
79

promtest

Package promtest provides helpers for testing applications which export Prometheus metrics. MIT Licensed.
Go
6
star
80

flightdeck

flightdeck is an experiment to create a highly customizable hardware/software interface for live streaming and other computer activities. Apache 2.0 Licensed.
Go
6
star
81

gosubsonic

Subsonic client library, written in Go. MIT Licensed.
Go
5
star
82

kcm

Package kcm provides access to Linux Kernel Connection Multiplexor sockets (AF_KCM). MIT Licensed.
Go
5
star
83

sshttp

Package sshttp provides functionality that enables some functionality of Go's net/http package to be used with SSH servers using SFTP. MIT Licensed.
Go
5
star
84

geneve

Package geneve implements marshaling and unmarshaling of Generic Network Virtualization Encapsulation (Geneve) headers, as described in the IETF internet draft: https://tools.ietf.org/html/draft-ietf-nvo3-geneve-02. MIT Licensed.
Go
4
star
85

modemmanager_exporter

Command modemmanager_exporter implements a Prometheus exporter for ModemManager and its devices. MIT Licensed.
Go
4
star
86

multinet

Package multinet allows combining multiple package net types into one. MIT Licensed.
4
star
87

pidfd

Package pidfd provides access to Linux process file descriptors. MIT Licensed.
Go
4
star
88

imagegrid

Package imagegrid enables composing one or more images into a single image, using a tiled grid pattern. MIT Licensed.
Go
4
star
89

launchpad

Package launchpad provides Go support for Novation Launchpad MIDI devices. MIT Licensed.
Go
4
star
90

fibrechannel

Package fibrechannel implements marshaling and unmarshaling of Fibre Channel frames. MIT Licensed.
Go
3
star
91

godigraph

Directed graph or "digraph" implementation, written in Go. MIT Licensed.
Go
3
star
92

netconsole

Package netconsole enables capture and processing of logs generated by the netconsole Linux kernel module. MIT Licensed.
Go
3
star
93

neighbor

Package neighbor enables network neighbor detection using operating system specific facilities. MIT Licensed.
Go
3
star
94

misc

A collection of miscellaneous pieces of code, saved for future reference and use. Feel free to use and modify anything in this repository.
PHP
3
star
95

mdlayher.com

Matt Layher's personal static website. MIT Licensed.
Go
3
star
96

p4

Package p4 provides a variety of facilities for lexing, parsing, and manipulating P4 source code. MIT Licensed.
Go
2
star
97

netconsoled

Command netconsoled provides a server that can receive and process logs generated by the netconsole Linux kernel module. MIT Licensed.
Go
2
star
98

arris

Package arris gathers statistics from the web interface of Arris cable modems. MIT Licensed.
Go
2
star
99

tapcam

Brewery tap camera image upload and display system.
Go
2
star
100

flac-rs

A pure Rust FLAC metadata parser, written as an experiment to learn more about Rust.
Rust
2
star