cidrindex

package

v1.50.2 Latest Latest Go to latest Published: Feb 9, 2026 License: Apache-2.0 Imports: 6 Imported by: 0

Details

This section is empty.

This section is empty.

This section is empty.

type Entry[T any] struct {
	CIDR     netip.Prefix
	Metadata T
}

type Index[T any] struct {
	// contains filtered or unexported fields
}

Index maintains a CIDR tree for fast IP-to-metadata lookups with LRU caching.

func NewIndex[T any](cacheSize uint32, cacheTTL time.Duration) (*Index[T], error)

NewIndex creates a new CIDR index with the specified cache size and TTL.

func (idx *Index[T]) Add(cidr netip.Prefix, metadata T) error

Add inserts a CIDR range with associated metadata into the index.

func (idx *Index[T]) Cleanup(ttl time.Duration) int

Cleanup removes deleted entries that are older than the specified TTL.

func (idx *Index[T]) Contains(ip netip.Addr) bool

Contains checks if the given IP address is contained in any CIDR range.

func (idx *Index[T]) Lookup(ip netip.Addr) (*LookupResult[T], bool)

Lookup finds the most specific CIDR range containing the given IP address.

func (idx *Index[T]) MarkDeleted(cidr netip.Prefix)

MarkDeleted marks the given CIDR range as deleted without removing it from the index.

func (idx *Index[T]) Rebuild(entries []Entry[T]) error

Rebuild replaces all entries in the index with the provided entries.

func (idx *Index[T]) Remove(cidr netip.Prefix) error

Remove deletes the given CIDR range from the index.

type LookupResult[T any] struct {
	IP         netip.Addr
	Metadata   T
	ResolvedAt time.Time
}