cache

README

This is a goinstall-able mirror of modified code already published at:
http://git.nic.cz/redmine/projects/godns/repository/show/cache

Online godoc documentation for this package (should be) available at:
http://gopkgdoc.appspot.com/pkg/github.com/cznic/dns/cache

Documentation

Overview

Package cache supports caching of DNS resource records.

Index

• func Secs0() int64
• type Cache
  • func New() *Cache
  • func (c *Cache) Add(rrs ...rr.RRs)
  • func (c *Cache) Enum(root string, handler func([]string, rr.Bytes) bool)
  • func (c *Cache) Get(name string) (rrs rr.RRs, hit bool)

Functions

func Secs0

func Secs0() int64

Secs0 returns the app start time in epoch seconds.

Types

type Cache

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

Cache is a cache holding DNS RRs. Cache is organized as a dns.Tree. Cache handles RR TTLs, expired RRs are removed as encountered. Cache is safe for concurrent access.

func New

func New() *Cache

New returns a newly created Cache.

func (*Cache) Add

func (c *Cache) Add(rrs ...rr.RRs)

Add will put or append RRs r into the cache owned by their rr.RR.Name. RRs TTLs are interpreted as being relative to current time.

func (*Cache) Enum

func (c *Cache) Enum(root string, handler func([]string, rr.Bytes) bool)

Enum will enumerate Cache. Writers are blocked until Enum finishes.

func (*Cache) Get

func (c *Cache) Get(name string) (rrs rr.RRs, hit bool)

Get will return rrs and true if non expired cached RRs owned by name are present in the cache. If Get encounters expired RRs they are scheduled for removal and not returned.