Flavio Crisciani e88bc31afa Vendoring Netlink library 8 years ago
..
nl e88bc31afa Vendoring Netlink library 8 years ago
LICENSE f2614f2107 project: use vndr for vendoring 8 years ago
README.md 5a1b06d7fd rerun vndr 8 years ago
addr.go 694c787123 Vendoring vishvananda/netlink @c682914 8 years ago
addr_linux.go e88bc31afa Vendoring Netlink library 8 years ago
bpf_linux.go d96baf28d4 Update netlink library (required for libnetwork) 8 years ago
class.go f2614f2107 project: use vndr for vendoring 8 years ago
class_linux.go f2614f2107 project: use vndr for vendoring 8 years ago
conntrack_linux.go e88bc31afa Vendoring Netlink library 8 years ago
conntrack_unspecified.go e88bc31afa Vendoring Netlink library 8 years ago
filter.go e88bc31afa Vendoring Netlink library 8 years ago
filter_linux.go e88bc31afa Vendoring Netlink library 8 years ago
handle_linux.go d96baf28d4 Update netlink library (required for libnetwork) 8 years ago
handle_unspecified.go ed758b604a Vendor netlink @ebdfb74 8 years ago
link.go ed758b604a Vendor netlink @ebdfb74 8 years ago
link_linux.go 694c787123 Vendoring vishvananda/netlink @c682914 8 years ago
link_tuntap_linux.go f2614f2107 project: use vndr for vendoring 8 years ago
neigh.go f2614f2107 project: use vndr for vendoring 8 years ago
neigh_linux.go d96baf28d4 Update netlink library (required for libnetwork) 8 years ago
netlink.go 694c787123 Vendoring vishvananda/netlink @c682914 8 years ago
netlink_linux.go 694c787123 Vendoring vishvananda/netlink @c682914 8 years ago
netlink_unspecified.go 694c787123 Vendoring vishvananda/netlink @c682914 8 years ago
order.go 694c787123 Vendoring vishvananda/netlink @c682914 8 years ago
protinfo.go ed758b604a Vendor netlink @ebdfb74 8 years ago
protinfo_linux.go ed758b604a Vendor netlink @ebdfb74 8 years ago
qdisc.go 694c787123 Vendoring vishvananda/netlink @c682914 8 years ago
qdisc_linux.go 694c787123 Vendoring vishvananda/netlink @c682914 8 years ago
route.go 694c787123 Vendoring vishvananda/netlink @c682914 8 years ago
route_linux.go 694c787123 Vendoring vishvananda/netlink @c682914 8 years ago
route_unspecified.go 694c787123 Vendoring vishvananda/netlink @c682914 8 years ago
rule.go f2614f2107 project: use vndr for vendoring 8 years ago
rule_linux.go d96baf28d4 Update netlink library (required for libnetwork) 8 years ago
socket.go 694c787123 Vendoring vishvananda/netlink @c682914 8 years ago
socket_linux.go 694c787123 Vendoring vishvananda/netlink @c682914 8 years ago
xfrm.go f2614f2107 project: use vndr for vendoring 8 years ago
xfrm_monitor_linux.go 694c787123 Vendoring vishvananda/netlink @c682914 8 years ago
xfrm_policy.go f2614f2107 project: use vndr for vendoring 8 years ago
xfrm_policy_linux.go f2614f2107 project: use vndr for vendoring 8 years ago
xfrm_state.go 694c787123 Vendoring vishvananda/netlink @c682914 8 years ago
xfrm_state_linux.go 694c787123 Vendoring vishvananda/netlink @c682914 8 years ago

README.md

netlink - netlink library for go

Build Status GoDoc

The netlink package provides a simple netlink library for go. Netlink is the interface a user-space program in linux uses to communicate with the kernel. It can be used to add and remove interfaces, set ip addresses and routes, and configure ipsec. Netlink communication requires elevated privileges, so in most cases this code needs to be run as root. Since low-level netlink messages are inscrutable at best, the library attempts to provide an api that is loosely modeled on the CLI provided by iproute2. Actions like ip link add will be accomplished via a similarly named function like AddLink(). This library began its life as a fork of the netlink functionality in docker/libcontainer but was heavily rewritten to improve testability, performance, and to add new functionality like ipsec xfrm handling.

Local Build and Test

You can use go get command:

go get github.com/vishvananda/netlink

Testing dependencies:

go get github.com/vishvananda/netns

Testing (requires root):

sudo -E go test github.com/vishvananda/netlink

Examples

Add a new bridge and add eth1 into it:

package main

import (
    "net"
    "github.com/vishvananda/netlink"
)

func main() {
    la := netlink.NewLinkAttrs()
    la.Name = "foo"
    mybridge := &netlink.Bridge{la}}
    _ := netlink.LinkAdd(mybridge)
    eth1, _ := netlink.LinkByName("eth1")
    netlink.LinkSetMaster(eth1, mybridge)
}

Note NewLinkAttrs constructor, it sets default values in structure. For now it sets only TxQLen to -1, so kernel will set default by itself. If you're using simple initialization(LinkAttrs{Name: "foo"}) TxQLen will be set to 0 unless you specify it like LinkAttrs{Name: "foo", TxQLen: 1000}.

Add a new ip address to loopback:

package main

import (
    "net"
    "github.com/vishvananda/netlink"
)

func main() {
    lo, _ := netlink.LinkByName("lo")
    addr, _ := netlink.ParseAddr("169.254.169.254/32")
    netlink.AddrAdd(lo, addr)
}

Future Work

Many pieces of netlink are not yet fully supported in the high-level interface. Aspects of virtually all of the high-level objects don't exist. Many of the underlying primitives are there, so its a matter of putting the right fields into the high-level objects and making sure that they are serialized and deserialized correctly in the Add and List methods.

There are also a few pieces of low level netlink functionality that still need to be implemented. Routing rules are not in place and some of the more advanced link types. Hopefully there is decent structure and testing in place to make these fairly straightforward to add.