nettools

type ArpEntry struct {
	Addr netip.Addr
	MAC  net.HardwareAddr
}

type Arper interface {
	FindHardwareAddrOf(context.Context, netip.Addr, ...arpRequestOptionFunc) (ArpEntry, error)
	FindUsingIfNameHardwareAddrOf(context.Context, string, netip.Addr, ...arpRequestOptionFunc) (ArpEntry, error)
}

type CertData struct {
	CommonName    string
	Version       string
	IsValid       bool
	DaysTilExpire int
	IssuedBy      string
}

type Dnser interface {
	FindFirstAddrOf(string) (netip.Addr, error)
	FindAddrsOf(string) ([]netip.Addr, error)
	FindHostnameOf(netip.Addr) (string, error)
	DNSCheckAllServers(context.Context, string) (map[string]map[string][]netip.Addr, error)
}

type ErrNoResponseW struct {
	Target netip.Addr
	OpErr  *net.OpError
	Err    error
}

type Icmp4EchoOption func(*Icmp4EchoOptions)

type Icmp4EchoOptions struct {
	ListenAddress   netip.Addr
	ReadTimeout     time.Duration
	IcmpID          int
	IcmpSeq         int
	TTL             int
	Count           int
	BetweenDuration time.Duration
	AllowAllErrors  bool
}

type Icmp4EchoResponse struct {
	Peer    netip.Addr
	Start   time.Time
	Elapsed time.Duration
	Err     error
}

type Icmp4EchoResponseStatistics struct {
	Peer         netip.Addr
	Start        time.Time
	TotalPackets int
	TotalElapsed time.Duration
	Mean         time.Duration
	Minimum      time.Duration
	Maximum      time.Duration
	StdDev       time.Duration
	SuccessCount int
	PacketLoss   float64
}

type Icmp4Echoer interface {
	Icmp4Echo(context.Context, netip.Addr, ...Icmp4EchoOption) ([]Icmp4EchoResponse, error)
}

type Ipifyer interface {
	GetExternalAddr(context.Context) (netip.Addr, error)
}

type Nettooler interface {
	Arper
	Dnser
	Icmp4Echoer
	Ipifyer
	Portscanner
	Snmper
	TLSer
	Utiler
}

type PortList int

type Portscanner interface {
	ScanTcpPorts(context.Context, netip.Addr, ...portscanRequestOptionFunc) ([]int, error)
}

type SnmpInfo struct {
	SystemInfo SnmpSystemInfo
	Interfaces []netip.Prefix
	ArpTable   []ArpEntry
}

type SnmpSystemInfo struct {
	Description string
	Contact     string
	Name        string
	Location    string
}

type Snmper interface {
	FetchSNMPInfo(context.Context, netip.Addr, ...snmpRequestOptionFunc) (SnmpInfo, error)
	SnmpGetSystemInfo(context.Context, netip.Addr, ...snmpRequestOptionFunc) (SnmpSystemInfo, error)
	SnmpGetInterfaces(context.Context, netip.Addr, ...snmpRequestOptionFunc) ([]netip.Prefix, error)
	SnmpGetArpTable(context.Context, netip.Addr, ...snmpRequestOptionFunc) ([]ArpEntry, error)
}

type TLS struct {
	ServerName    string
	CommonName    string
	Version       string
	IsValid       bool
	DaysTilExpire int
	IssuedBy      string
	Chain         []CertData
	TLSData       *tls.ConnectionState
}

type TLSer interface {
	FetchTLS(string) (TLS, error)
}

type Utiler interface {
	IsRandomMac(net.HardwareAddr) bool
	GetUserAgent() string
	OuiLookup(net.HardwareAddr) (string, error)
}