Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

masterfile

package module

Go to main page

Versions in this module

v1

v1.0.0

Oct 28, 2026

Changes in this version

+ func Format(w io.Writer, apex string, entries []Entry, bumpSerial bool) error

+ func WritePlain(w io.Writer, apex string, entries []Entry) error

+ type File struct

+ Entries []Entry

+ func (f *File) Origin(hint string) (string, *Entry)

+ func (f *File) Records() iter.Seq2[int, Entry]

+ func (f *File) ResolveOwners(apex string) error

v0

v0.2.2

Oct 28, 2026

v0.2.1

Oct 28, 2026

v0.2.0

Oct 28, 2026

Changes in this version

+ var ErrApexMismatch = errors.New("apex mismatch")

+ var ErrInvalidEntry = errors.New("invalid entry")

+ var ErrInvalidName = errors.New("invalid name")

+ var ErrInvalidRecord = errors.New("invalid record")

+ var ErrNoOrigin = errors.New("no origin")

+ var ErrNoSOA = errors.New("no SOA record")

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

+ var ErrNotInZone = errors.New("owner not in zone")

+ var ErrUnsafeWrite = errors.New("unsafe write")

+ func Absolute(name, origin string) string

+ func Comments(data []byte) ([]string, error)

+ func EntriesEqual(a, b []Entry) bool

+ func Fqdn(name string) string

+ func InZone(name, apex string) bool

+ func Increase(serial string) string

+ func IsReverseZone(apex string) bool

+ func LongestZone(name string, apexes []string) (apex string, ok bool)

+ func NameEqual(a, b string) bool

+ func Quote(s string) string

+ func Records(apex string, data []byte) (map[string]int, error)

+ func Reformat(data []byte, apex string, w io.Writer, bumpSerial bool) error

+ func Relative(name, origin string) string

+ func ReverseAddr(name string) (netip.Addr, bool)

+ func ReverseName(addr netip.Addr) string

+ func ReversePrefix(apex string) (netip.Prefix, bool)

+ func StringToTTL(s string) (uint32, bool)

+ func ToASCII(name string) (string, error)

+ func ToUnicode(name string) string

+ func UserComment(c string) string

+ func Verify(apex string, plain, formatted []byte) error

+ type AddRemove struct

+ Add []string

+ Owner string

+ Placement Placement

+ Remove []string

+ TTL uint32

+ Type uint16

+ type Anchor struct

+ Owner string

+ Prefix string

+ Type uint16

+ Under string

+ type Collapse struct

+ Drop []string

+ Keep string

+ KeepTTL uint32

+ Owner string

+ Placement Placement

+ Type uint16

+ type Delete struct

+ type DeleteOwner struct

+ Owner string

+ type Entry struct

+ func NewComment(text string) (Entry, error)

+ func NewDirective(name string, args ...string) (Entry, error)

+ func NewRecord(owner string, ttl uint32, rtype uint16, rdata string) (Entry, error)

+ func (e Entry) Args() []Field

+ func (e Entry) Class() string

+ func (e Entry) Comment() string

+ func (e Entry) Comments() []string

+ func (e Entry) Content() string

+ func (e Entry) Equal(o Entry) bool

+ func (e Entry) Fields() []Field

+ func (e Entry) Head() []string

+ func (e Entry) Kind() Kind

+ func (e Entry) Line() int

+ func (e Entry) Name() string

+ func (e Entry) Owner() string

+ func (e Entry) RType() uint16

+ func (e Entry) RawValues() []string

+ func (e Entry) TTL() (TTL, bool)

+ func (e Entry) Tail() []string

+ func (e Entry) Type() string

+ func (e Entry) Values() []string

+ func (e Entry) WithComments(comments ...string) Entry

+ func (e Entry) WithOwner(name string) Entry

+ type Field struct

+ Comments []string

+ Quoted bool

+ Raw string

+ Value string

+ type Insert struct

+ Owner string

+ Placement Placement

+ Records []RR

+ type Kind int

+ const Blank

+ const Comment

+ const Directive

+ const Record

+ func (k Kind) String() string

+ type Op interface

+ type ParseError struct

+ Col int

+ Line int

+ Msg string

+ func (e *ParseError) Error() string

+ type Placement []Anchor

+ type RR struct

+ Content string

+ TTL uint32

+ Type uint16

+ type RRSet struct

+ Contents []string

+ Owner string

+ TTL uint32

+ Type string

+ type Replace struct

+ Mode ReplaceMode

+ MustExist bool

+ Placement Placement

+ Records []RR

+ type ReplaceMode int

+ const ReplaceAll

+ const ReplaceFirst

+ type Result struct

+ Changed bool

+ Index int

+ Inserted int

+ Matched int

+ Removed int

+ type Selector struct

+ Contents []string

+ Owner string

+ Types []uint16

+ type TTL struct

+ Raw string

+ Seconds uint32

+ type Zone struct

+ Changed bool

+ Entries []Entry

+ func New(apex string) *Zone

+ func Parse(data []byte, apex string) (*Zone, error)

+ func (z *Zone) AbsoluteOwner(e Entry) string

+ func (z *Zone) Apex() string

+ func (z *Zone) Apply(ops ...Op) ([]Result, error)

+ func (z *Zone) Check() error

+ func (z *Zone) Commit(bumpSerial bool) (data []byte, changed bool, err error)

+ func (z *Zone) DefaultPlacement(owner string, rtype uint16) Placement

+ func (z *Zone) Format(w io.Writer, bumpSerial bool) error

+ func (z *Zone) Owners(sel Selector) []string

+ func (z *Zone) RRSets() []RRSet

+ func (z *Zone) Records() iter.Seq2[int, Entry]

+ func (z *Zone) SOA() (Entry, bool)

+ func (z *Zone) Select(sel Selector) []Entry

+ func (z *Zone) Serial() (uint32, bool)

+ func (z *Zone) WritePlain(w io.Writer) error