netbind

Documentation

Overview

Package netbind resolves operator-friendly local-address specifications for connections that must bypass a host TUN route.

Index

• func IsDynamic(spec string) bool
• func Resolve(spec string) (netip.Addr, error)
• func Validate(spec string) error

Functions

func IsDynamic

func IsDynamic(spec string) bool

IsDynamic reports whether resolving spec depends on live interface state. Literal addresses are stable configuration; automatic and interface-bound specifications can disappear and reappear as links change.

func Resolve

func Resolve(spec string) (netip.Addr, error)

Resolve returns the address selected by a literal IP, "if:NAME", or "auto". Automatic and interface modes deliberately consider only IPv4 addresses on active, non-loopback, non-point-to-point interfaces. Excluding point-to-point interfaces prevents a Clash or other host TUN from being selected as the outer path. Ambiguity is reported instead of guessing.

func Validate

func Validate(spec string) error

Validate checks a literal IP, "auto", or "if:NAME" without requiring the interface to be present yet. Interface state can change between validation and a later dial, so Resolve repeats this check.