tun

func AddTunAddr ¶

func AddTunAddr(tun gtun.Tun, addr string) error

AddTunAddr updates list off addrs of provided Tun.

The address must be a CIDR prefix such as "10.0.0.1/32" or "fd00::1/128". The Tun must expose a non-nil File; otherwise sysnet.ErrUnknownTun is returned.

func AddTunRoute ¶

func AddTunRoute(tun gtun.Tun, route string) error

AddTunRoute updates list off routes of provided Tun.

The route must be a CIDR prefix such as "10.0.0.0/24" or "fd00::/64". The Tun must expose a non-nil File; otherwise sysnet.ErrUnknownTun is returned.

func CreateDefaultTUN ¶

func CreateDefaultTUN(base string, mtu int) (gtun.Tun, error)

CreateDefaultTUN creates a TUN device whose name is generated from base.

Unlike tuntap.CreateTUN, base is not used as the exact interface name. Instead, each attempt uses the template "<base>-<rand>", where rand is a freshly generated 5-character alpha-numeric string. For example, base "vpn" can produce "vpn-aZ38fK02Lm".

If the generated name is already occupied, CreateDefaultTUN generates another random suffix and tries again. Only name-occupied errors are retryable; random generation failures, invalid names, permission errors, missing /dev/net/tun, unsupported MTU values, and all other tuntap.CreateTUN errors are returned immediately.

func GetTunAddrs ¶

func GetTunAddrs(tun gtun.Tun) ([]string, error)

GetTunAddrs returns list off addrs of provided Tun.

Returned entries are CIDR prefixes assigned to the interface. The Tun must expose a non-nil File; otherwise sysnet.ErrUnknownTun is returned.

func GetTunRotue ¶

func GetTunRotue(tun gtun.Tun) ([]string, error)

GetTunRotue returns list off routes of provided Tun.

The misspelling is kept to match the gonnect sysnet.System interface. The Tun must expose a non-nil File; otherwise sysnet.ErrUnknownTun is returned.

func SetTunAddrs ¶

func SetTunAddrs(tun gtun.Tun, addrs []string) error

SetTunAddrs updates list off addrs of provided Tun.

Existing interface addresses are removed before the new CIDR addresses are added. The Tun must expose a non-nil File; otherwise sysnet.ErrUnknownTun is returned.

func SetTunMTU ¶

func SetTunMTU(tun gtun.Tun, mtu int) error

SetTunMTU updates MTU of provided Tun.

The Tun must expose a non-nil File; otherwise sysnet.ErrUnknownTun is returned. Values lower than the IPv4 minimum MTU are replaced with a sensible default of 1420 bytes.

func SetTunName ¶

func SetTunName(tun gtun.Tun) ([]string, error)

SetTunName updates name of provided Tun.

The current gonnect sysnet.System interface does not provide a replacement name argument, so this function validates that the Tun is known through its File and returns the current kernel interface name. If File is nil, sysnet.ErrUnknownTun is returned.

func SetTunRoutes ¶

func SetTunRoutes(tun gtun.Tun, routes []string) error

SetTunRoutes updates list off routes of provided Tun.

Existing main-table routes whose output interface is the Tun are removed before the provided CIDR routes are added. The Tun must expose a non-nil File; otherwise sysnet.ErrUnknownTun is returned.