netmon

Documentation

Overview

Package monitor provides facilities for monitoring network interface and route changes. It primarily exists to know when portable devices move between different networks.

Index

• type ChangeFunc
• type Monitor
  • func New(logf logger.Logf) (*Monitor, error)
  • func (m *Monitor) Close() error
  • func (m *Monitor) GatewayAndSelfIP() (gw, myIP netip.Addr, ok bool)
  • func (m *Monitor) InjectEvent()
  • func (m *Monitor) InterfaceState() *interfaces.State
  • func (m *Monitor) RegisterChangeCallback(callback ChangeFunc) (unregister func())
  • func (m *Monitor) RegisterRuleDeleteCallback(callback RuleDeleteCallback) (unregister func())
  • func (m *Monitor) Start()
• type RuleDeleteCallback

Types

type ChangeFunc

type ChangeFunc func(changed bool, state *interfaces.State)

ChangeFunc is a callback function registered with Monitor that's called when the network changed. The changed parameter is whether the network changed enough for State to have changed since the last callback.

type Monitor

type Monitor struct {
	// contains filtered or unexported fields
}

Monitor represents a monitoring instance.

func New

func New(logf logger.Logf) (*Monitor, error)

New instantiates and starts a monitoring instance. The returned monitor is inactive until it's started by the Start method. Use RegisterChangeCallback to get notified of network changes.

func (*Monitor) Close

func (m *Monitor) Close() error

Close closes the monitor.

func (*Monitor) GatewayAndSelfIP

func (m *Monitor) GatewayAndSelfIP() (gw, myIP netip.Addr, ok bool)

GatewayAndSelfIP returns the current network's default gateway, and the machine's default IP for that gateway.

It's the same as interfaces.LikelyHomeRouterIP, but it caches the result until the monitor detects a network change.

func (*Monitor) InjectEvent

func (m *Monitor) InjectEvent()

InjectEvent forces the monitor to pretend there was a network change and re-check the state of the network. Any registered ChangeFunc callbacks will be called within the event coalescing period (under a fraction of a second).

func (*Monitor) InterfaceState

func (m *Monitor) InterfaceState() *interfaces.State

InterfaceState returns the latest snapshot of the machine's network interfaces.

The returned value is owned by Mon; it must not be modified.

func (*Monitor) RegisterChangeCallback

func (m *Monitor) RegisterChangeCallback(callback ChangeFunc) (unregister func())

RegisterChangeCallback adds callback to the set of parties to be notified (in their own goroutine) when the network state changes. To remove this callback, call unregister (or close the monitor).

func (*Monitor) RegisterRuleDeleteCallback

func (m *Monitor) RegisterRuleDeleteCallback(callback RuleDeleteCallback) (unregister func())

RegisterRuleDeleteCallback adds callback to the set of parties to be notified (in their own goroutine) when a Linux ip rule is deleted. To remove this callback, call unregister (or close the monitor).

func (*Monitor) Start

func (m *Monitor) Start()

Start starts the monitor. A monitor can only be started & closed once.

type RuleDeleteCallback

type RuleDeleteCallback func(table uint8, priority uint32)

RuleDeleteCallback is a callback when a Linux IP policy routing rule is deleted. The table is the table number (52, 253, 354) and priority is the priority order number (for Tailscale rules currently: 5210, 5230, 5250, 5270)