func ExecBackground(t *testing.T, processNamestring, netNS *os.File, namestring, args []string) (<-chanerror, func()error)

func TestBigUDP(t *testing.T, loggerslog.Logger, _ *url.URL, conn *tailnet.Conn, _, peerClient)

func TestSuite(t *testing.T, _slog.Logger, serverURL *url.URL, conn *tailnet.Conn, _, peerClient)

type BasicClientStarter struct {BlockEndpointsboolDERPForceWebsocketsbool// WaitForConnection means wait for (any) peer connection before returning from StartClientWaitForConnectionbool// WaitForConnection means wait for a direct peer connection before returning from StartClientWaitForDirectbool// Service is a network service (e.g. an echo server) to start on the client. If Wait* is set, the service is// started prior to waiting.ServiceNetworkServiceLogPacketsbool}

func (BasicClientStarter)StartClient¶added inv2.24.0

func (bBasicClientStarter) StartClient(t *testing.T, loggerslog.Logger, serverURL *url.URL, derpMap *tailcfg.DERPMap, me, peerClient) *tailnet.Conn

type Client struct {NumberClientNumberIDuuid.UUIDListenPortuint16ShouldRunTestsboolTunnelSrcbool}

type ClientNumberint

type ClientStarter interface {StartClient(t *testing.T, loggerslog.Logger, serverURL *url.URL, derpMap *tailcfg.DERPMap, meClient, peerClient) *tailnet.Conn}

type NGINXServerOptions struct {SimpleServerOptions}

func (NGINXServerOptions)StartServer¶added inv2.12.0

func (oNGINXServerOptions) StartServer(t *testing.T, loggerslog.Logger, listenAddrstring)

type NetworkService interface {StartService(t *testing.T, loggerslog.Logger, conn *tailnet.Conn)}

type NetworkingLoopback struct{}

func (NetworkingLoopback)SetupNetworking¶added inv2.24.0

func (NetworkingLoopback) SetupNetworking(t *testing.T, _slog.Logger)TestNetworking

type NetworkingNAT struct {StunCountintClient1HardboolClient2Hardbool}

func (NetworkingNAT)SetupNetworking¶added inv2.24.0

func (nNetworkingNAT) SetupNetworking(t *testing.T, lslog.Logger)TestNetworking

SetupNetworking creates a fake internet with multiple STUN servers and sets upNAT forwarding rules. Client NATs are controlled by the switches ClientXHard, which if true, sets up hardnat.

type NetworkingProvider interface {// SetupNetworking creates interfaces and network namespaces for the test.// The most simple implementation is NetworkSetupDefault, which only creates// a network namespace shared for all tests.SetupNetworking(t *testing.T, loggerslog.Logger)TestNetworking}

type ServerStarter interface {// StartServer should start the server and return once it's listening. It// should not block once it's listening. Cleanup should be handled by// t.Cleanup.StartServer(t *testing.T, loggerslog.Logger, listenAddrstring)}

type SimpleServerOptions struct {// FailUpgradeDERP will make the DERP server fail to handle the initial DERP// upgrade in a way that causes the client to fallback to// DERP-over-WebSocket fallback automatically.// Incompatible with DERPWebsocketOnly.FailUpgradeDERPbool// DERPWebsocketOnly will make the DERP server only accept WebSocket// connections. If a DERP request is received that is not using WebSocket// fallback, the test will fail.// Incompatible with FailUpgradeDERP.DERPWebsocketOnlybool}

func (SimpleServerOptions)Router¶added inv2.12.0

func (oSimpleServerOptions) Router(t *testing.T, loggerslog.Logger) *chi.Mux

func (SimpleServerOptions)StartServer¶added inv2.12.0

func (oSimpleServerOptions) StartServer(t *testing.T, loggerslog.Logger, listenAddrstring)

type TestNetworking struct {ServerTestNetworkingServerSTUNs   []TestNetworkingSTUNClient1TestNetworkingClientClient2TestNetworkingClient}

type TestNetworkingClient struct {ProcessTestNetworkingProcess// ServerAccessURL is the hostname and port that the client uses to access// the server over HTTP for coordination.ServerAccessURLstring// DERPMap is the DERP map that the client uses. If nil, a basic DERP map// containing only a single DERP with `ServerAccessURL` is used with no// STUN servers.DERPMap *tailcfg.DERPMap}

func (TestNetworkingClient)ResolveDERPMap¶added inv2.12.0

func (cTestNetworkingClient) ResolveDERPMap() (*tailcfg.DERPMap,error)

type TestNetworkingProcess struct {// NetNS to enter. If nil, the current network namespace is used.NetNS *os.File}

func (TestNetworkingProcess)CapturePackets¶added inv2.24.0

func (pTestNetworkingProcess) CapturePackets(t *testing.T, name, dirstring)

type TestNetworkingSTUN struct {ProcessTestNetworkingProcessIPstringListenAddrstring}

type TestNetworkingServer struct {ProcessTestNetworkingProcessListenAddrstring}

type TestTopology struct {NamestringNetworkingProviderNetworkingProvider// Server is the server starter for the test. It is executed in the server// subprocess.ServerServerStarter// ClientStarter.StartClient gets called in each client subprocess. It's expected to// create the tailnet.Conn and ensure connectivity to it's peer.ClientStarterClientStarter// RunTests is the main test function. It's called in each of the client// subprocesses. If tests can only run once, they should check the client ID// and return early if it's not the expected one.RunTests func(t *testing.T, loggerslog.Logger, serverURL *url.URL, conn *tailnet.Conn, meClient, peerClient)}

type TriangleNetwork struct {Client1MTUint}

func (TriangleNetwork)SetupNetworking¶added inv2.24.0

func (nTriangleNetwork) SetupNetworking(t *testing.T, lslog.Logger)TestNetworking

SetupNetworking creates multiple namespaces with a central router in the following topology.. ┌──────────────┐. │ │. │ Server ├─────────────────────────────────────┐. │ │fdac:38fa:ffff:3::2 │. └──────────────┘ │ fdac:38fa:ffff:3::1. ┌──────────────┐ ┌─────┴───────┐. │ │ fdac:38fa:ffff:1::1│ │. │ Client 1 ├───────────────────────────────┤ Router │. │ │fdac:38fa:ffff:1::2 │ │. └──────────────┘ └─────┬───────┘. ┌──────────────┐ │ fdac:38fa:ffff:2::1. │ │ │. │ Client 2 ├─────────────────────────────────────┘. │ │fdac:38fa:ffff:2::2. └──────────────┘The veth link between Client 1 and the router has a configurable MTU via Client1MTU.

type UDPEchoService struct{}

func (UDPEchoService)StartService¶added inv2.24.0

func (UDPEchoService) StartService(t *testing.T, loggerslog.Logger, _ *tailnet.Conn)