netmonitor

type AddrChange struct {
	IfIndex   int
	IfAddress *net.IPNet
	Deleted   bool
}

type DHCPInfo struct {
	Subnet     *net.IPNet
	NtpServers []net.IP
}

type DNSInfo struct {
	ResolvConfPath string
	Domains        []string
	DNSServers     []net.IP
}

type DNSInfoChange struct {
	IfIndex int
	Info    DNSInfo
}

type Event interface {
	// contains filtered or unexported methods
}

type IfAttrs struct {
	// Index of the interface
	IfIndex int
	// Name of the interface.
	IfName string
	// IfType should be one of the link types as defined in ip-link(8).
	IfType string
	// True if interface is a loopback interface.
	IsLoopback bool
	// True if interface supports broadcast access capability.
	WithBroadcast bool
	// True if interface is administratively enabled.
	AdminUp bool
	// True if interface is ready to transmit data at the L1 layer.
	LowerUp bool
	// True if interface is a slave of another interface (e.g. a sub-interface).
	Enslaved bool
	// If interface is enslaved, this should contain index of the master interface.
	MasterIfIndex int
	// Maximum Transmission Unit configured on the interface.
	MTU uint16
}

type IfChange struct {
	Attrs IfAttrs
	// True if this is a newly added interface.
	Added bool
	// True if interface was removed.
	Deleted bool
}

type LinuxNetworkMonitor struct {
	Log *base.LogObject
	// contains filtered or unexported fields
}

type MockInterface struct {
	Attrs   IfAttrs
	IPAddrs []*net.IPNet
	HwAddr  net.HardwareAddr
	DNS     DNSInfo
	DHCP    DHCPInfo
}

type MockNetworkMonitor struct {
	sync.Mutex
	Log    *base.LogObject
	MainRT int // inject syscall.RT_TABLE_MAIN for Linux network stack
	// contains filtered or unexported fields
}

type NetworkMonitor interface {
	// ListInterfaces returns all available network interfaces.
	ListInterfaces() (ifNames []string, err error)
	// GetInterfaceIndex : get interface index. Both name and index are unique
	// interface identifiers, but while name is usually used in user-facing
	// contexts, index is preferred in APIs (may vary between different network stacks).
	// At least within NetworkMonitor, index is the preferred identifier and can be used
	// with the methods below to obtain interface attributes, assigned addresses, etc.
	// Do not keep the index for too long however, the mapping between the name and
	// the index may change as interfaces are added/deleted.
	GetInterfaceIndex(ifName string) (ifIndex int, exists bool, err error)
	// GetInterfaceAttrs : get interface attributes (not including assigned addresses).
	GetInterfaceAttrs(ifIndex int) (IfAttrs, error)
	// GetInterfaceAddrs : get MAC address and a list of IP addresses assigned
	// to the given interface.
	GetInterfaceAddrs(ifIndex int) ([]*net.IPNet, net.HardwareAddr, error)
	// GetInterfaceDNSInfo : get DNS information associated with the given interface.
	GetInterfaceDNSInfo(ifIndex int) (DNSInfo, error)
	// GetInterfaceDHCPInfo : get DHCP information associated with the given interface.
	// This information should be retrieved from the DHCP client.
	GetInterfaceDHCPInfo(ifIndex int) (DHCPInfo, error)
	// GetInterfaceDefaultGWs : return a list of IP addresses of default gateways
	// used by the given interface. Includes both statically configured GWs as well as
	// those assigned by DHCP.
	GetInterfaceDefaultGWs(ifIndex int) ([]net.IP, error)
	// ListRoutes returns routes currently present in the routing tables.
	// The set of routes to list can be filtered.
	ListRoutes(filters RouteFilters) ([]Route, error)
	// ClearCache : clear cached mappings between interface names, interface indexes,
	// attributes, assigned addresses, DNS info, DHCP info and default GWs.
	// It is reasonable to do this once in a while because the monitor can miss some
	// notification from the network stack and therefore the cache can get out-of-date
	// over time.
	ClearCache()
	// WatchEvents : subscribe to watch for changes happening inside the network stack
	// related to interfaces, routes, DNS, etc.
	// The returned channel should be reasonably buffered.
	WatchEvents(ctx context.Context, subName string) <-chan Event
}

type Route struct {
	IfIndex int
	Dst     *net.IPNet
	Gw      net.IP
	Table   int
	// Network-stack specific data.
	Data interface{}
}

type RouteChange struct {
	Route
	Added   bool
	Deleted bool
}

type RouteFilters struct {
	// Enable to retrieve routes only from the given table.
	FilterByTable bool
	Table         int

	// Enable to retrieve only those routes which are associated
	// with the given interface.
	FilterByIf bool
	IfIndex    int
}