probe

type Env struct {
	Host       string // target name, for the HTTP Host header and TLS
	Privileged bool   // raw ICMP sockets allowed
}

type Hop struct {
	IP   netip.Addr
	Sent int
	RTTs []time.Duration
}

type Prober interface {
	Probe(ip string, count int, timeout time.Duration) Result
}

type Resolution struct {
	IP      netip.Addr
	Latency time.Duration
	Looked  bool // false for a literal address
	Err     error
}

type Result struct {
	Sent     int
	Received int
	RTTs     []time.Duration // answered samples, in order
	Err      error           // last error, for diagnostics
	Metrics  map[string]float64
}

type Trace struct {
	Hops    []Hop
	Reached bool // the destination answered
	Err     error
}

type TraceSpec struct {
	Protocol  check.Protocol // check.TraceUDP or check.TraceICMP
	Port      int            // udp destination, 0 for DefaultTracePort
	LocalPort int            // udp source, 0 for ephemeral
	MaxHops   int
	Count     int           // probes per hop
	Timeout   time.Duration // per probe
	// Called before each probe, for rate limiting. Optional.
	Wait func(ctx context.Context) error
}