zone

Sep 3, 2026

Changes in this version

type Controller

+ UpdatePTR func(ctx context.Context, target string, addresses []netip.Addr, mode PTRUpdateMode) (changed bool, err error)

type DomainCtrl

+ func (s *DomainCtrl) UpdatePTR(ctx context.Context, target string, addresses []netip.Addr, mode PTRUpdateMode) (changed bool, err error)

type File

+ func (s *File) DeletePTRRecord(ctx context.Context, ptrName, target string) (changed bool, err error)

+ func (s *File) UpdatePTRAddress(ctx context.Context, ptrName, target string, mode PTRUpdateMode) (changed bool, err error)

type Option

+ func WithDDNSManagePTR(enable bool) Option

+ type PTRUpdateMode string

+ const PTRUpdateAppend

+ const PTRUpdateReplace

+ const PTRUpdateReplaceAll

May 17, 2026

Changes in this version

type Controller

+ func NewWithOptions(opts []Option, zonefiles ...string) (Controller, error)

+ type Option func(*DomainCtrl)

+ func WithAcmeTTL(ttl int) Option

Apr 4, 2026

Changes in this version

type Controller

+ DeleteRRSet func(ctx context.Context, zoneName, name, typ string) (changed bool, err error)

+ GetZone func(ctx context.Context, zoneName string) (ZoneSnapshot, error)

+ ListZones func(ctx context.Context) ([]ZoneSnapshot, error)

+ ReplaceRRSet func(ctx context.Context, zoneName, name, typ string, ttl int, values []string) (changed bool, err error)

type DomainCtrl

+ func (s *DomainCtrl) DeleteRRSet(ctx context.Context, zoneName, name, typ string) (changed bool, err error)

+ func (s *DomainCtrl) GetZone(ctx context.Context, zoneName string) (ZoneSnapshot, error)

+ func (s *DomainCtrl) ListZones(ctx context.Context) ([]ZoneSnapshot, error)

+ func (s *DomainCtrl) ReplaceRRSet(ctx context.Context, zoneName, name, typ string, ttl int, values []string) (changed bool, err error)

type File

+ func (s *File) DeleteRRSet(ctx context.Context, name, typ string) (changed bool, err error)

+ func (s *File) ReplaceRRSet(ctx context.Context, name, typ string, ttl int, values []string) (changed bool, err error)

+ func (s *File) Snapshot(_ context.Context) (ZoneSnapshot, error)

+ type RRSet struct

+ Name string

+ Records []string

+ TTL int

+ Type string

+ type ZoneSnapshot struct

+ ID string

+ Name string

+ Nameservers []string

+ RRsets []RRSet

+ Serial uint32

Feb 12, 2026

Changes in this version

+ var ErrOriginChanged = errors.New("zone origin changed")

+ var ErrZoneNotFound = errors.New("zone not found")

Jan 3, 2026

Changes in this version

+ var ErrNoMatchers = errors.New("no record matchers provided")

+ var ErrRecordNotFound = errors.New("record not found")

type Controller

+ ZMUpdateRecord func(ctx context.Context, domain string, typ string, values []string) (changed bool, err error)

type DomainCtrl

+ func (s *DomainCtrl) ZMUpdateRecord(ctx context.Context, domain string, typ string, values []string) (changed bool, err error)

type File

+ func (s *File) ZMUpdateRecord(ctx context.Context, domain string, typ string, newValues []string) (changed bool, err error)

+ type Matcher struct

+ Domain []byte

+ RRType uint16

+ Values [][]byte

+ func (m Matcher) Match(e zonefile.Entry) bool

+ func (m Matcher) String() string

+ type Matchers []Matcher

+ func (mm Matchers) Match(e zonefile.Entry) bool

Dec 16, 2025

Changes in this version

+ const EmptyPlaceholder

+ var ErrSoaNotFound = errors.New("SOA not found")

+ func PrintEntries(entries []zonefile.Entry, w io.Writer)

+ func StripOrigin(name, origin string) string

+ type Controller interface

+ UpdateACMEChallenge func(ctx context.Context, domain string, token string) error

+ UpdateDDNSAddress func(ctx context.Context, domain string, addrs []netip.Addr) error

+ func New(zonefiles ...string) (Controller, error)

+ type DomainCtrl struct

+ func (s *DomainCtrl) UpdateACMEChallenge(ctx context.Context, domain string, token string) error

+ func (s *DomainCtrl) UpdateDDNSAddress(ctx context.Context, domain string, addrs []netip.Addr) error

+ type File struct

+ func (s *File) UpdateACMEChallenge(ctx context.Context, domain string, token string) error

+ func (s *File) UpdateDDNSAddress(ctx context.Context, domain string, addrs []netip.Addr) error