trace

type Config struct {
	Context          context.Context
	OSType           int
	ICMPMode         int
	SrcAddr          string
	SrcPort          int
	SourceDevice     string
	BeginHop         int
	MaxHops          int
	NumMeasurements  int
	MaxAttempts      int
	ParallelRequests int
	Timeout          time.Duration
	DstIP            net.IP
	DstPort          int
	Quic             bool
	IPGeoSource      ipgeo.Source
	RDNS             bool
	AlwaysWaitRDNS   bool
	PacketInterval   int
	TTLInterval      int
	Lang             string
	DN42             bool
	RealtimePrinter  func(res *Result, ttl int)
	AsyncPrinter     func(res *Result)
	PktSize          int
	RandomPacketSize bool
	TOS              int
	Maptrace         bool
	DisableMPLS      bool
}

type GlobalpingOptions struct {
	Target  string
	From    string
	IPv4    bool
	IPv6    bool
	TCP     bool
	UDP     bool
	Port    int
	Packets int
	MaxHops int

	DisableMaptrace bool
	DataOrigin      string

	TablePrint   bool
	ClearScreen  bool
	ClassicPrint bool
	RawPrint     bool
	JSONPrint    bool
}

type Hop struct {
	Success  bool
	Address  net.Addr
	Hostname string
	TTL      int
	RTT      time.Duration
	Error    error
	Geo      *ipgeo.IPGeoData
	Lang     string
	MPLS     []string
}

type ICMPTracer struct {
	Config

	SrcIP net.IP
	// contains filtered or unexported fields
}

type ICMPTracerv6 struct {
	Config

	SrcIP net.IP
	// contains filtered or unexported fields
}

type MTRAggregator struct {
	// contains filtered or unexported fields
}

type MTRHopStat struct {
	TTL      int              `json:"ttl"`
	Host     string           `json:"host,omitempty"`
	IP       string           `json:"ip,omitempty"`
	Loss     float64          `json:"loss_percent"`
	Snt      int              `json:"snt"`
	Last     float64          `json:"last_ms"`
	Avg      float64          `json:"avg_ms"`
	Best     float64          `json:"best_ms"`
	Wrst     float64          `json:"wrst_ms"`
	StDev    float64          `json:"stdev_ms"`
	Geo      *ipgeo.IPGeoData `json:"geo,omitempty"`
	MPLS     []string         `json:"mpls,omitempty"`
	Received int              `json:"received"`
}

type MTROnSnapshot func(iteration int, stats []MTRHopStat)

type MTROptions struct {
	// Interval 每轮之间的等待间隔（默认 1s）。
	// 仅在 legacy round-based 模式（Web MTR）使用。
	Interval time.Duration
	// MaxRounds 最大轮次，0 表示无限运行直到取消。
	// 仅在 legacy round-based 模式使用。
	MaxRounds int
	// HopInterval 同一 TTL 两次探测之间的间隔（per-hop 调度模式）。
	// > 0 时启用 per-hop 调度，忽略 Interval / MaxRounds。
	HopInterval time.Duration
	// MaxPerHop 每个 TTL 最大探测次数，0 表示无限。
	MaxPerHop int
	// IsPaused 可选：返回 true 时暂停探测（轮询检查）。
	IsPaused func() bool
	// IsResetRequested 可选：返回 true（原子消费）时重置统计。
	IsResetRequested func() bool
	// ProgressThrottle 流式预览最小刷新间隔（默认 200ms）。
	ProgressThrottle time.Duration
	// AsyncMetadata causes interactive per-hop MTR to render bare hops first,
	// then patch Geo/RDNS metadata into existing rows asynchronously.
	AsyncMetadata bool
}

type MTRRawOnRecord func(rec MTRRawRecord)

type MTRRawOptions struct {
	// Interval is the delay between rounds (default: 1s).
	// Legacy round-based mode only.
	Interval time.Duration
	// MaxRounds is the max number of rounds. 0 means run forever until canceled.
	// Legacy round-based mode only.
	MaxRounds int
	// HopInterval is the per-hop probe interval (per-hop scheduling mode).
	// > 0 activates per-hop scheduling; Interval/MaxRounds are ignored.
	HopInterval time.Duration
	// MaxPerHop is the max probes per TTL in per-hop mode. 0 = unlimited.
	MaxPerHop int
	// RunRound optionally overrides the traceroute call for each round.
	// It is mainly for callers that need per-round locking or global-state setup.
	// Legacy round-based mode only.
	RunRound func(method Method, cfg Config) (*Result, error)
}

type MTRRawRecord struct {
	Iteration int      `json:"iteration"`
	TTL       int      `json:"ttl"`
	Success   bool     `json:"success"`
	IP        string   `json:"ip,omitempty"`
	Host      string   `json:"host,omitempty"`
	RTTMs     float64  `json:"rtt_ms"`
	ASN       string   `json:"asn,omitempty"`
	Country   string   `json:"country,omitempty"`
	Prov      string   `json:"prov,omitempty"`
	City      string   `json:"city,omitempty"`
	District  string   `json:"district,omitempty"`
	Owner     string   `json:"owner,omitempty"`
	Lat       float64  `json:"lat"`
	Lng       float64  `json:"lng"`
	MPLS      []string `json:"mpls,omitempty"`
}

type MTRSnapshot struct {
	Iteration int          `json:"iteration"`
	Stats     []MTRHopStat `json:"stats"`
}

type Method string

type PacketSizeSpec struct {
	PayloadSize int
	Random      bool
}

type Result struct {
	Hops [][]Hop

	TraceMapUrl string
	// contains filtered or unexported fields
}

type TCPTracer struct {
	Config

	SrcIP net.IP
	// contains filtered or unexported fields
}

type TCPTracerIPv6 struct {
	Config

	SrcIP net.IP
	// contains filtered or unexported fields
}

type Tracer interface {
	Execute() (*Result, error)
}

type UDPTracer struct {
	Config

	SrcIP net.IP
	// contains filtered or unexported fields
}

type UDPTracerIPv6 struct {
	Config

	SrcIP net.IP
	// contains filtered or unexported fields
}