Files
cloudpods/vendor/github.com/vishvananda/netns/README.md
Yousong Zhou 37fc897a11 Feature/yousong vpc elb (#11423)
* regiondrivers: kvm: lb: make "network" an optional argument

* loadbalancernetworks: add MacAddr field for lb with eip

* apis: compute: add LOADBALANCER to EIP_ASSOCIATE_VALID_TYPES

* regiondrivers: fix typo RequestAssociat{,e}Eip

* regiondrivers: kvm: RequestAssociatEip: standalone func for each type

* regiondrivers: kvm: RequestAssociateEip: support loadbalancer

* tasks: EipAssociateTask: add support for loadbalancer

* tasks: EipAssociateTask: allow using name for referring to instance

* elasticips: PerformAssociate: validate loadbalancer condition

* tasks: EipDissociateTask: support non-managed loadbalancer

* loadbalancers: add StartSyncstatus method for EipAssociateTask

* regiondrivers: kvm: allow creation of vpc lb

* loadbalanceragents: add timestamp fields for network objects

* climc: eips: add associate type loadbalancer

* mcclient: loadbalancernetworks: add Mac_Addr column

* vpcagent: models: add loadbalancernetworks

* vpcagent: ovn: route back vpc cidr block instead of all rest

* vpcagent: ovn: add ClaimLoadbalancerNetwork()

* mcclient: models: add LoadbalancerNetwork

* mcclient: models: add Network

* lbagent: models: use IBaseManager to accomodate joint manager

* lbagent: models: add {,Loadbalancer}Networks

* lbagent: models: export a few fields

* lbagent: models: add fields for vpc lb models

* iproute2: add NewAddressEx constructor

* lbagent: add worker for vpc lb

* vendor: add github.com/coreos/go-iptables

* lbagent: apihelper: use ovn worker

* lbagent: models: use pkg/compute/models

* mcclient: models: remove lb models

* lbagent: api: use pkg/apihelper

* vpcagent: models: add lblisteners and lbacls

* vpcagent: ovn: add lbacl support
2022-05-06 23:22:50 +08:00

1.5 KiB

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)
}

NOTE

The library can be safely used only with Go >= 1.10 due to golang/go#20676.

After locking a goroutine to its current OS thread with runtime.LockOSThread() and changing its network namespace, any new subsequent goroutine won't be scheduled on that thread while it's locked. Therefore, the new goroutine will run in a different namespace leading to unexpected results.

See here for more details.