netns

Documentation

Overview

Package netns contains various utility functions to work with network namespaces

Index

• Constants
• func GetNetNSCookie() (uint64, error)
• func ListNamedNetNSWithPrefix(prefix string) ([]string, error)
• func RemoveIfFromNetNSIfExists(netNS ns.NetNS, ifName string) error
• func RemoveIfFromNetNSWithNameIfBothExist(netNSName, ifName string) error
• func RemoveNetNSWithName(netNSName string) error
• func ReplaceNetNSWithName(netNSName string) (ns.NetNS, error)

Constants

const SO_NETNS_COOKIE = 71

Functions

func GetNetNSCookie

func GetNetNSCookie() (uint64, error)

GetNetNSCookie tries to retrieve the cookie of the host netns.

func ListNamedNetNSWithPrefix

func ListNamedNetNSWithPrefix(prefix string) ([]string, error)

ListNamedNetNSWithPrefix returns list of named network namespaces which name starts with the given prefix.

func RemoveIfFromNetNSIfExists

func RemoveIfFromNetNSIfExists(netNS ns.NetNS, ifName string) error

RemoveIfFromNetNSIfExists removes the given interface from the given network namespace.

If the interface does not exist, no error will be returned.

func RemoveIfFromNetNSWithNameIfBothExist

func RemoveIfFromNetNSWithNameIfBothExist(netNSName, ifName string) error

RemoveIfFromNetNSWithNameIfBothExist removes the given interface from the given network namespace identified by its name.

If either the interface or the namespace do not exist, no error will be returned.

func RemoveNetNSWithName

func RemoveNetNSWithName(netNSName string) error

RemoveNetNSWithName removes the given named network namespace.

FIXME: replace "ip-netns" invocations with native Go code

func ReplaceNetNSWithName

func ReplaceNetNSWithName(netNSName string) (ns.NetNS, error)

ReplaceNetNSWithName creates a network namespace with the given name and returns a handle to it. If such netns already exists from a previous run, it will be removed and then re-created to avoid any previous state of the netns.

Example usage of this function:

netns0, err := netns.ReplaceNetNSWithName(netnsName)
if err != nil {
  return err
}
defer netns.RemoveNetNSWithName(netnsName)

netns0.Do(func(_ ns.NetNS) error {
  <logic to be executed within the new netns>
})

FIXME: replace "ip-netns" invocations with native Go code