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
	// 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 one of the tids. If tids is empty, either
	// dnsx.Default, and if that fails, dnsx.System or dnsx.Goos tids.
	Lookup(q []byte, tids ...string) ([]byte, error)
	// LookupFor resolves q over client-code preferred tid conveyed via
	// DNSOpts returned from DNSListener.OnQuery. As a special case, UID
	// may be protect.UidSelf ("rethink") 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.
	LookupFor(q []byte, uid string) ([]byte, error)
	// LookupNetIP is like Lookup but with empty tids.
	LookupNetIP(ctx context.Context, network, host string) ([]netip.Addr, error)
	// LookupNetIPFor is like LookupFor
	LookupNetIPFor(ctx context.Context, network, host, uid string) ([]netip.Addr, error)
	// LookupNetIPOn is like Lookup but with tids set to some preset IDs.
	LookupNetIPOn(ctx context.Context, network, host string, tids ...string) ([]netip.Addr, error)
}

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

type IPSetType int