connector

Documentation

Overview

Package connector is responsible for the datapath specific plumbing to connect an endpoint to the network

Index

• Constants
• func CheckLink(linkName string) error
• func ConfigureNetNSForIPVLAN(netNsPath string) (mapFD, mapID int, err error)
• func CreateAndSetupIpvlanSlave(id string, slaveIfName string, netNs ns.NetNS, mtu int, masterDev int, ...) (int, error)
• func CreateIpvlanSlave(id string, mtu, masterDev int, mode string, ep *models.EndpointChangeRequest) (*netlink.IPVlan, *netlink.Link, string, error)
• func DeriveEndpointFrom(hostDevice, containerID string, pid int) (*models.EndpointChangeRequest, error)
• func DisableRpFilter(ifName string) error
• func Endpoint2IfName(endpointID string) string
• func Endpoint2TempIfName(endpointID string) string
• func Endpoint2TempRandIfName() string
• func GetNetInfoFromPID(pid int) (int, string, net.IP, error)
• func GetVethInfo(nodeIfName string, parentIdx int, netNSMac string, ...) error
• func IPv4Gateway(addr *models.NodeAddressing) string
• func IPv4Routes(addr *models.NodeAddressing, linkMTU int) ([]route.Route, error)
• func IPv6Gateway(addr *models.NodeAddressing) string
• func IPv6Routes(addr *models.NodeAddressing, linkMTU int) ([]route.Route, error)
• func SetupVeth(id string, mtu int, ep *models.EndpointChangeRequest) (*netlink.Veth, *netlink.Link, string, error)
• func SetupVethRemoteNs(netNs ns.NetNS, srcIfName, dstIfName string) (int, int, error)
• func SetupVethWithNames(lxcIfName, tmpIfName string, mtu int, ep *models.EndpointChangeRequest) (*netlink.Veth, *netlink.Link, error)
• func SufficientAddressing(addr *models.NodeAddressing) error

Constants

const (
	// OperationModeL3S will respect iptables rules e.g. set up for masquerading
	OperationModeL3S = "L3S"

	// OperationModeL3 will bypass iptables rules on the host
	OperationModeL3 = "L3"
)

Available option for DaemonConfig.Ipvlan.OperationMode

const (
	// ContainerInterfacePrefix is the container's internal interface name prefix.
	ContainerInterfacePrefix = "cilium"
)

Functions

func CheckLink

func CheckLink(linkName string) error

CheckLink returns an error if a link with linkName does not exist.

func ConfigureNetNSForIPVLAN

func ConfigureNetNSForIPVLAN(netNsPath string) (mapFD, mapID int, err error)

ConfigureNetNSForIPVLAN sets up IPVLAN in the specified network namespace. Returns the file descriptor for the tail call map / ID, and an error if any operation while configuring said namespace fails.

func CreateAndSetupIpvlanSlave

func CreateAndSetupIpvlanSlave(id string, slaveIfName string, netNs ns.NetNS, mtu int, masterDev int, mode string, ep *models.EndpointChangeRequest) (int, error)

CreateAndSetupIpvlanSlave creates an ipvlan slave device for the given master device, moves it to the given network namespace, and finally initializes it (see setupIpvlanInRemoteNs).

func CreateIpvlanSlave

func CreateIpvlanSlave(id string, mtu, masterDev int, mode string, ep *models.EndpointChangeRequest) (*netlink.IPVlan, *netlink.Link, string, error)

CreateIpvlanSlave creates an ipvlan slave in L3 based on the master device.

func DeriveEndpointFrom

func DeriveEndpointFrom(hostDevice, containerID string, pid int) (*models.EndpointChangeRequest, error)

func DisableRpFilter

func DisableRpFilter(ifName string) error

DisableRpFilter tries to disable rpfilter on specified interface

func Endpoint2IfName

func Endpoint2IfName(endpointID string) string

Endpoint2IfName returns the host interface name for the given endpointID.

func Endpoint2TempIfName

func Endpoint2TempIfName(endpointID string) string

Endpoint2TempIfName returns the temporary interface name for the given endpointID.

func Endpoint2TempRandIfName

func Endpoint2TempRandIfName() string

Endpoint2TempRandIfName returns a random, temporary interface name for the given endpointID. This is similar to Endpoint2TempIfName() but uses a random string instead of endpoint ID.

func GetNetInfoFromPID

func GetNetInfoFromPID(pid int) (int, string, net.IP, error)

GetNetInfoFromPID returns the index of the interface parent, the MAC address and IP address of the first interface that contains an IP address with global scope.

func GetVethInfo

func GetVethInfo(nodeIfName string, parentIdx int, netNSMac string, ep *models.EndpointChangeRequest) error

GetVethInfo populates the given endpoint with the arguments provided where * nodeIfName - Node Interface Name * parentIdx - Interface Index of the container veth pair in the host side. * netNSMac - MAC address of the veth pair in the container side.

func IPv4Gateway

func IPv4Gateway(addr *models.NodeAddressing) string

IPv4Gateway returns the IPv4 gateway address for endpoints.

func IPv4Routes

func IPv4Routes(addr *models.NodeAddressing, linkMTU int) ([]route.Route, error)

IPv4Routes returns IPv4 routes to be installed in endpoint's networking namespace.

func IPv6Gateway

func IPv6Gateway(addr *models.NodeAddressing) string

IPv6Gateway returns the IPv6 gateway address for endpoints.

func IPv6Routes

func IPv6Routes(addr *models.NodeAddressing, linkMTU int) ([]route.Route, error)

IPv6Routes returns IPv6 routes to be installed in endpoint's networking namespace.

func SetupVeth

func SetupVeth(id string, mtu int, ep *models.EndpointChangeRequest) (*netlink.Veth, *netlink.Link, string, error)

SetupVeth sets up the net interface, the temporary interface and fills up some endpoint fields such as mac, NodeMac, ifIndex and ifName. Returns a pointer for the created veth, a pointer for the temporary link, the name of the temporary link and error if something fails.

func SetupVethRemoteNs

func SetupVethRemoteNs(netNs ns.NetNS, srcIfName, dstIfName string) (int, int, error)

SetupVethRemoteNs renames the netdevice in the target namespace to the provided dstIfName.

func SetupVethWithNames

func SetupVethWithNames(lxcIfName, tmpIfName string, mtu int, ep *models.EndpointChangeRequest) (*netlink.Veth, *netlink.Link, error)

SetupVethWithNames sets up the net interface, the temporary interface and fills up some endpoint fields such as mac, NodeMac, ifIndex and ifName. Returns a pointer for the created veth, a pointer for the temporary link, the name of the temporary link and error if something fails.

func SufficientAddressing

func SufficientAddressing(addr *models.NodeAddressing) error

SufficientAddressing returns an error if the provided NodeAddressing does not provide sufficient information to derive all IPAM required settings.