speedtest

Documentation

Overview

Package speedtest contains both server and client code for running speedtests between tailscale nodes.

Index

• Constants
• func Serve(l net.Listener) error
• type Direction
  • func (d *Direction) Reverse()
  • func (d Direction) String() string
• type Result
  • func RunClient(direction Direction, duration time.Duration, host string) ([]Result, error)
  • func (r Result) Interval() time.Duration
  • func (r Result) MBitsPerSecond() float64
  • func (r Result) MegaBits() float64
  • func (r Result) MegaBytes() float64

Constants

const (
	MinDuration     = 5 * time.Second  // minimum duration for a test
	DefaultDuration = MinDuration      // default duration for a test
	MaxDuration     = 30 * time.Second // maximum duration for a test

	DefaultPort = 20333
)

Functions

func Serve

func Serve(l net.Listener) error

Serve starts up the server on a given host and port pair. It starts to listen for connections and handles each one in a goroutine. Because it runs in an infinite loop, this function only returns if any of the speedtests return with errors, or if the listener is closed.

Types

type Direction

type Direction int

const (
	Download Direction = iota
	Upload
)

func (*Direction) Reverse

func (d *Direction) Reverse()

func (Direction) String

func (d Direction) String() string

type Result

type Result struct {
	Bytes         int       // number of bytes sent/received during the interval
	IntervalStart time.Time // start of the interval
	IntervalEnd   time.Time // end of the interval
	Total         bool      // if true, this result struct represents the entire test, rather than a segment of the test
}

This represents the Result of a speedtest within a specific interval

func RunClient

func RunClient(direction Direction, duration time.Duration, host string) ([]Result, error)

RunClient dials the given address and starts a speedtest. It returns any errors that come up in the tests. If there are no errors in the test, it returns a slice of results.

func (Result) Interval

func (r Result) Interval() time.Duration

func (Result) MBitsPerSecond

func (r Result) MBitsPerSecond() float64

func (Result) MegaBits

func (r Result) MegaBits() float64

func (Result) MegaBytes

func (r Result) MegaBytes() float64