From 3bce8328a2e92d0b74c394e4ebdc2643b45fe793 Mon Sep 17 00:00:00 2001
From: Brad Fitzpatrick <bradfitz@tailscale.com>
Date: Thu, 6 May 2021 10:23:45 -0700
Subject: [PATCH] tailcfg: ping request notes WIP
---
tailcfg/tailcfg.go | 18 ++++++++++++++++++
1 file changed, 18 insertions(+)
diff --git a/tailcfg/tailcfg.go b/tailcfg/tailcfg.go
index 1c49a19dd..3a61bd83c 100644
--- a/tailcfg/tailcfg.go
+++ b/tailcfg/tailcfg.go
@@ -884,6 +884,24 @@ type PingRequest struct {
// Log is whether to log about this ping in the success case.
// For failure cases, the client will log regardless.
Log bool `json:",omitempty"`
+
+ Initiator string // admin@email; "system" (for Tailscale)
+ TestIP netaddr.IP
+ Types string // empty means all: TSMP+ICMP+disco
+ StopAfterNDirect int // 1 means stop on 1st direct ping; 4 means 4 direct pings; 0 means do MaxPings and stop
+ MaxPings int // MaxPings total, direct or DERPed
+ PayloadSize int // default: 0 extra bytes
+}
+
+type StreamedPingResult struct {
+ IP netaddr.IP
+ SeqNum int // somewhat redundant with TxID but for clarity
+ SentTo NodeID // for exit/subnet relays
+ TxID string // N hex bytes random
+ Dir string // "in"/"out"
+ Type string // ICMP, disco, TSMP, ...
+ Via string // "direct", "derp-nyc", ...
+ Seconds float64 // for Dir "in" only
}
type MapResponse struct {