tsd

Documentation

Overview

Package tsd (short for "Tailscale Daemon") contains a System type that containing all the subsystems a Tailscale node (tailscaled or platform equivalent) uses.

The goal of this package (as of 2023-05-03) is to eventually unify initialization across tailscaled, tailscaled as a Windows services, the mac GUI, tsnet, wasm, tests, and other places that wire up all the subsystems. And doing so without weird optional interface accessors on some subsystems that return other subsystems. It's all a work in progress.

This package depends on nearly all parts of Tailscale, so it should not be imported by (or thus passed to) any package that does not want to depend on the world. In practice this means that only things like cmd/tailscaled, ipn/ipnlocal, and ipn/ipnserver should import this package.

Index

• type SubSystem
  • func (p *SubSystem[T]) Get() T
  • func (p *SubSystem[T]) GetOK() (_ T, ok bool)
  • func (p *SubSystem[T]) Set(v T)
• type System
  • func (s *System) IsNetstack() bool
  • func (s *System) IsNetstackRouter() bool
  • func (s *System) Set(v any)

Types

type SubSystem

type SubSystem[T any] struct {
	// contains filtered or unexported fields
}

SubSystem represents some subsystem of the Tailscale node daemon.

A subsystem can be set to a value, and then later retrieved. A subsystem value tracks whether it's been set and, once set, doesn't allow the value to change.

func (*SubSystem[T]) Get

func (p *SubSystem[T]) Get() T

Get returns the value of p, panicking if it hasn't been set.

func (*SubSystem[T]) GetOK

func (p *SubSystem[T]) GetOK() (_ T, ok bool)

GetOK returns the value of p (if any) and whether it's been set.

func (*SubSystem[T]) Set

func (p *SubSystem[T]) Set(v T)

Set sets p to v.

It panics if p is already set to a different value.

Set must not be called concurrently with other Sets or Gets.

type System

type System struct {
	Dialer         SubSystem[*tsdial.Dialer]
	DNSManager     SubSystem[*dns.Manager] // can get its *resolver.Resolver from DNSManager.Resolver
	Engine         SubSystem[wgengine.Engine]
	NetMon         SubSystem[*netmon.Monitor]
	MagicSock      SubSystem[*magicsock.Conn]
	NetstackRouter SubSystem[bool] // using Netstack at all (either entirely or at least for subnets)
	Router         SubSystem[router.Router]
	Tun            SubSystem[*tstun.Wrapper]
	StateStore     SubSystem[ipn.StateStore]
}

System contains all the subsystems of a Tailscale node (tailscaled, etc.)

func (*System) IsNetstack

func (s *System) IsNetstack() bool

IsNetstack reports whether Tailscale is running as a netstack-based TUN-free engine.

func (*System) IsNetstackRouter

func (s *System) IsNetstackRouter() bool

IsNetstackRouter reports whether Tailscale is either fully netstack based (without TUN) or is at least using netstack for routing.

func (*System) Set

func (s *System) Set(v any)

Set is a convenience method to set a subsystem value. It panics if the type is unknown or has that type has already been set.