ipmap

type IPMap interface {
	IPMapper
	// Resolves hostOrIP and adds the resulting IPs to its IPSet.
	// hostOrIP may be host:port, or ip:port, or host, or ip.
	Add(hostOrIP string) *IPSet
	// Returns the IPSet for host, creating it if necessary, with
	// ips as its initial or appended contents.
	AddMany(host string, ips []netip.Addr) *IPSet
	// Get creates an IPSet for this hostname populated with the IPs
	// discovered by resolving it. Subsequent calls to Get return the
	// same IPSet. Never returns nil.
	// hostOrIP may be host:port, or ip:port, or host, or ip.
	Get(hostOrIP string) *IPSet
	// GetAny creates an IPSet for this hostname, which may be empty.
	// Subsequent calls to GetAny return the same IPSet. Never returns nil.
	// hostOrIP may be host:port, or ip:port, or host, or ip.
	GetAny(hostOrIP string) *IPSet
	// GetMany returns a list of sampled IPs from the ipmap cache.
	// ipver is one of "v4", "v6", or "" (for both).
	GetMany(n uint8, ipver string) []netip.Addr
	// MakeIPSet creates an IPSet for this hostname bootstrapped with given IPs
	// or IP:Ports. Subsequent calls to MakeIPSet return a new, overridden IPSet.
	// hostOrIP may be host:port, or ip:port, or host, or ip.
	MakeIPSet(hostOrIP string, ipps []string, typ IPSetType) *IPSet
	// Reverse lookup; returns hostnames for the given IP address.
	ReverseGet(ip netip.Addr) []string
	// ReverseGetMany returns a list of sampled hostnames from the ipmap cache.
	// ipver is one of "v4", "v6", or "" (for both).
	ReverseGetMany(n uint8, ipver string) []string
	// With sets the default resolver to use for hostname resolution.
	With(r IPMapper)
	// Clear removes all IPSets from the map.
	Clear()
}

type IPMapper interface {
	// Lookup resolves q over client-code preferred tid conveyed via
	// DNSOpts returned from DNSListener.OnQuery. As a special case, UID
	// may be protect.MyUid or core.UNKNOWN_UID_STR ("-1")
	// but otherwise it is usually a Linux user-id assigned to a process
	// which presumably is requesting this lookup. If tids is empty, either
	// dnsx.Default, and if that fails, dnsx.System or dnsx.Goos tids.
	Lookup(q []byte, uid string, tids ...string) ([]byte, error)
	// LookupNetIP is like Lookup but for hostname to IP addresses.
	LookupNetIP(ctx context.Context, network, host, uid string, tids ...string) ([]netip.Addr, error)
}

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

type IPSetType int