Simple network namespace handling for go.
Go to file
Matthieu MOREL 59920981a6
ci(lint): setup YAML Lint step (#68)
Setup YAMLLint

---------

Signed-off-by: Matthieu MOREL <matthieu.morel35@gmail.com>
2023-02-05 09:30:06 -08:00
.github ci(lint): setup YAML Lint step (#68) 2023-02-05 09:30:06 -08:00
.golangci.yml gha: add golangci-lint 2023-01-18 13:02:58 -08:00
.yamllint.yml ci(lint): setup YAML Lint step (#68) 2023-02-05 09:30:06 -08:00
LICENSE Initial commit of netns package 2014-08-31 14:20:31 -07:00
README.md Drop note about `go` `1.10` compatibility 2023-01-13 12:20:54 -08:00
doc.go move package description to a doc.go 2023-01-13 09:56:59 -08:00
go.mod go.mod: update minimum version to go1.17 2023-01-13 12:18:28 -08:00
go.sum chore(deps): bump golang.org/x/sys to v0.2.0 2023-01-13 09:58:21 -08:00
netns_linux.go go.mod: update minimum version to go1.17 2023-01-13 12:18:28 -08:00
netns_linux_test.go fix unhandled error in TestGetNewSetDelete 2023-01-13 09:56:59 -08:00
netns_others.go make deprecated consts an alias, and don't use internally 2023-01-13 09:56:59 -08:00
nshandle_linux.go code clean for the Ns(none) return string. (#67) 2023-01-23 10:27:00 -08:00
nshandle_others.go code clean for the Ns(none) return string. (#67) 2023-01-23 10:27:00 -08: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 the network namespace
    ifaces, _ := net.Interfaces()
    fmt.Printf("Interfaces: %v\n", ifaces)

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