Simple network namespace handling for go.

Go to file

Zhenfang Wei 11c323fbd3 Fixed the docker netns detection err on xenial (#15 ) With ubuntu 16.04 and docker-engine 1.11, the docker netns detection function failed to look for the correct location of task file. This change fixed the issue. Signed-off-by: Zhenfang Wei <kopkop@gmail.com>		2016-04-29 22:37:00 -07:00
LICENSE	Initial commit of netns package	2014-08-31 14:20:31 -07:00
README.md	Fix example code	2016-02-24 23:51:21 +09:00
netns.go	Added function UniqueId which returns a string that uniquely identifies (#14 )	2016-04-29 22:36:46 -07:00
netns_linux.go	Fixed the docker netns detection err on xenial (#15 )	2016-04-29 22:37:00 -07:00
netns_test.go	Fix handling of namespaces in multi-threaded processes.	2015-01-26 16:46:24 -08:00
netns_unspecified.go	Add Build Flags	2015-05-20 19:27:24 +01:00

README.md

netns - network namespaces in go

The netns package provides an ultra-simple interface for handling network namespaces in go. Changing namespaces requires elevated privileges, so in most cases this code needs to be run as root.

Local Build and Test

You can use go get command:

go get github.com/vishvananda/netns

Testing (requires root):

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

Example

package main

import (
    "fmt"
    "net"
    "runtime"
    "github.com/vishvananda/netns"
)

func main() {
    // Lock the OS Thread so we don't accidentally switch namespaces
    runtime.LockOSThread()
    defer runtime.UnlockOSThread()

    // Save the current network namespace
    origns, _ := netns.Get()
    defer origns.Close()

    // Create a new network namespace
    newns, _ := netns.New()
    defer newns.Close()

    // Do something with tne network namespace
    ifaces, _ := net.Interfaces()
    fmt.Printf("Interfaces: %v\n", ifaces)

    // Switch back to the original namespace
    netns.Set(origns)
}