netstack

Documentation

Overview

Package netstack wires up gVisor's netstack into Tailscale.

Index

• func NewSubnetRouterWrapper(r router.Router) router.Router
• type DNSMap
  • func DNSMapFromNetworkMap(nm *netmap.NetworkMap) DNSMap
  • func (m DNSMap) Resolve(ctx context.Context, addr string) (netaddr.IPPort, error)
• type Impl
  • func Create(logf logger.Logf, tundev *tstun.Wrapper, e wgengine.Engine, mc *magicsock.Conn) (*Impl, error)
  • func (ns *Impl) DialContextTCP(ctx context.Context, addr string) (*gonet.TCPConn, error)
  • func (ns *Impl) DialContextUDP(ctx context.Context, addr string) (*gonet.UDPConn, error)
  • func (ns *Impl) Start() error

Functions

func NewSubnetRouterWrapper

func NewSubnetRouterWrapper(r router.Router) router.Router

NewSubnetRouterWrapper returns a Router wrapper that prevents the underlying Router r from seeing any advertised subnet routes, as netstack will handle them instead.

Types

type DNSMap

type DNSMap map[string]netaddr.IP

DNSMap maps MagicDNS names (both base + FQDN) to their first IP. It should not be mutated once created.

func DNSMapFromNetworkMap

func DNSMapFromNetworkMap(nm *netmap.NetworkMap) DNSMap

func (DNSMap) Resolve

func (m DNSMap) Resolve(ctx context.Context, addr string) (netaddr.IPPort, error)

Resolve resolves addr into an IP:port using first the MagicDNS contents of m, else using the system resolver.

type Impl

type Impl struct {
	// ForwardTCPIn, if non-nil, handles forwarding an inbound TCP
	// connection.
	// TODO(bradfitz): provide mechanism for tsnet to reject a
	// port other than accepting it and closing it.
	ForwardTCPIn func(c net.Conn, port uint16)

	// ProcessLocalIPs is whether netstack should handle incoming
	// traffic directed at the Node.Addresses (local IPs).
	// It can only be set before calling Start.
	ProcessLocalIPs bool

	// ProcessSubnets is whether netstack should handle incoming
	// traffic destined to non-local IPs (i.e. whether it should
	// be a subnet router).
	// It can only be set before calling Start.
	ProcessSubnets bool
	// contains filtered or unexported fields
}

Impl contains the state for the netstack implementation, and implements wgengine.FakeImpl to act as a userspace network stack when Tailscale is running in fake mode.

func Create

func Create(logf logger.Logf, tundev *tstun.Wrapper, e wgengine.Engine, mc *magicsock.Conn) (*Impl, error)

Create creates and populates a new Impl.

func (*Impl) DialContextTCP

func (ns *Impl) DialContextTCP(ctx context.Context, addr string) (*gonet.TCPConn, error)

func (*Impl) DialContextUDP

func (ns *Impl) DialContextUDP(ctx context.Context, addr string) (*gonet.UDPConn, error)

func (*Impl) Start

func (ns *Impl) Start() error

Start sets up all the handlers so netstack can start working. Implements wgengine.FakeImpl.